Fungsi MsiViewFetch (msiquery.h)
Fungsi MsiViewFetch mengambil rekaman berurutan berikutnya dari tampilan. Fungsi ini mengembalikan handel yang harus ditutup menggunakan MsiCloseHandle.
Sintaks
UINT MsiViewFetch(
[in] MSIHANDLE hView,
[out] MSIHANDLE *phRecord
);
Parameter
[in] hView
Tangani ke tampilan untuk diambil.
[out] phRecord
Penunjuk ke handel untuk rekaman yang diambil.
Nilai kembali
Perhatikan bahwa dalam situasi memori rendah, fungsi ini dapat meningkatkan pengecualian STATUS_NO_MEMORY.
Keterangan
Jika fungsi MsiViewFetch mengembalikan ERROR_FUNCTION_FAILED, ada kemungkinan bahwa fungsi MsiViewExecute tidak dipanggil terlebih dahulu. Jika lebih banyak baris tersedia dalam tataan hasil, MsiViewFetch mengembalikan phRecord sebagai handel ke rekaman yang berisi data kolom yang diminta, atau phRecord adalah 0. Untuk performa maksimum, rekaman yang sama harus digunakan untuk semua pengambilan, atau rekaman harus dirilis dengan keluar dari cakupan.
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
Persyaratan | Nilai |
---|---|
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 |