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

Lihat juga

Fungsi Akses Database Umum

Bekerja dengan Kueri