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 |