Fungsi MsiGetActiveDatabase (msiquery.h)

Fungsi MsiGetActiveDatabase mengembalikan database aktif untuk penginstalan. Fungsi ini mengembalikan handel baca-saja yang harus ditutup menggunakan MsiCloseHandle.

Sintaks

MSIHANDLE MsiGetActiveDatabase(
  [in] MSIHANDLE hInstall
);

Parameter

[in] hInstall

Tangani penginstalan yang disediakan untuk tindakan kustom DLL atau diperoleh melalui MsiOpenPackage, MsiOpenPackageEx, atau MsiOpenProduct.

Menampilkan nilai

Jika fungsi berhasil, fungsi mengembalikan handel baca-saja ke database yang saat ini digunakan oleh alat penginstal. Jika fungsi gagal, fungsi mengembalikan nol, 0.

Keterangan

Fungsi MsiGetActiveDatabase mengakses database yang digunakan oleh penginstalan yang sedang berjalan.

Perhatikan bahwa disarankan untuk menggunakan variabel jenis PMSIHANDLE karena alat penginstal menutup objek PMSIHANDLE saat keluar dari cakupan, sedangkan Anda harus menutup objek MSIHANDLE dengan memanggil MsiCloseHandle. Untuk informasi selengkapnya lihat Menggunakan PMSIHANDLE alih-alih bagian HANDLE di Praktik Terbaik Penginstal Windows.

Persyaratan

Klien minimum yang didukung	Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Pemasang Windows pada Windows Server 2003 atau Windows XP
Target Platform	Windows
Header	msiquery.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Fungsi Akses Database Umum