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
MSICOLINFO_NAMES	Nama kolom dikembalikan.
MSICOLINFO_TYPES	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