Fungsi MsiDatabaseGetPrimaryKeysA (msiquery.h)
Fungsi MsiDatabaseGetPrimaryKeys mengembalikan rekaman yang berisi nama semua kolom kunci primer untuk tabel tertentu. Fungsi ini mengembalikan handel yang harus ditutup menggunakan MsiCloseHandle.
Sintaks
UINT MsiDatabaseGetPrimaryKeysA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szTableName,
[out] MSIHANDLE *phRecord
);
Parameter
[in] hDatabase
Tangani ke database. Lihat Mendapatkan Handel Database.
[in] szTableName
Menentukan nama tabel untuk mendapatkan nama kunci primer.
[out] phRecord
Penunjuk ke handel rekaman yang menyimpan nama kunci primer.
Mengembalikan nilai
Fungsi ini mengembalikan UINT.
Keterangan
Jumlah bidang rekaman yang dikembalikan adalah jumlah kolom kunci primer yang dikembalikan oleh fungsi MsiDatabaseGetPrimaryKeys . Rekaman yang dikembalikan berisi nama tabel di Bidang (0) dan nama kolom yang membentuk nama kunci utama dalam bidang yang berhasil. Nama kunci utama ini sesuai dengan nomor kolom untuk bidang.
Fungsi ini tidak dapat digunakan dengan tabel _Tables atau tabel _Columns.
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.
Catatan
Header msiquery.h mendefinisikan MsiDatabaseGetPrimaryKeys sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
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 |