Fungsi MsiViewGetColumnInfo (msiquery.h)
Fungsi MsiViewGetColumnInfo mengembalikan rekaman yang berisi nama atau definisi kolom. Fungsi ini mengembalikan handel yang harus ditutup menggunakan MsiCloseHandle.
Sintaks
UINT MsiViewGetColumnInfo(
[in] MSIHANDLE hView,
[in] MSICOLINFO eColumnInfo,
[out] MSIHANDLE *phRecord
);
Parameter
[in] hView
Tangani ke tampilan untuk mendapatkan informasi kolom.
[in] eColumnInfo
Menentukan bendera yang menunjukkan jenis informasi apa yang diperlukan. Parameter ini harus menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Nama kolom dikembalikan. |
|
Definisi dikembalikan. |
[out] phRecord
Penunjuk ke handel untuk menerima rekaman data informasi kolom.
Mengembalikan nilai
Perhatikan bahwa dalam situasi memori rendah, fungsi ini dapat meningkatkan pengecualian STATUS_NO_MEMORY.
Keterangan
Deskripsi kolom yang dikembalikan oleh MsiViewGetColumnInfo berada dalam format yang dijelaskan di bagian: Format Definisi Kolom. Setiap kolom dijelaskan oleh string di bidang rekaman terkait. String definisi terdiri dari satu huruf yang mewakili jenis data diikuti dengan lebar kolom (dalam karakter jika berlaku, byte sebaliknya). Lebar nol menunjuk lebar tidak terbatas (misalnya, bidang teks panjang dan aliran). Huruf besar menunjukkan bahwa nilai null diperbolehkan dalam kolom.
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 |