Fungsi MsiCreateRecord (msiquery.h)
Fungsi MsiCreateRecord membuat objek rekaman baru dengan jumlah bidang yang ditentukan. Fungsi ini mengembalikan handel yang harus ditutup menggunakan MsiCloseHandle.
Sintaks
MSIHANDLE MsiCreateRecord(
[in] UINT cParams
);
Parameter
[in] cParams
Menentukan jumlah bidang yang akan dimiliki rekaman. Jumlah maksimum bidang dalam rekaman dibatasi hingga 65535.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan ditangani ke objek rekaman baru.
Jika fungsi gagal, nilai yang dikembalikan adalah null.
Keterangan
Bidang 0 dari objek rekaman yang dibuat oleh fungsi MsiCreateRecord digunakan untuk string format dan kode operasi dan tidak disertakan dalam hitungan yang ditentukan oleh cParams. Semua bidang diinisialisasi ke null.
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. Windows Installer pada Windows Server 2003 atau Windows XP |
| Target Platform | Windows |
| Header | msiquery.h |
| Pustaka | Msi.lib |
| DLL | Msi.dll |