Fungsi MsiDatabaseGetPrimaryKeysA (msiquery.h)

  • Artikel

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

Lihat juga

Fungsi Akses Database Umum