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

Lihat juga

Fungsi Database

Fungsi Pemrosesan Rekaman