Fungsi MsiGetProductCodeA (msi.h)

Artikel
11/20/2024

Fungsi MsiGetProductCode mengembalikan kode produk aplikasi dengan menggunakan kode komponen dari komponen aplikasi yang diinstal atau diiklankan. Selama inisialisasi, aplikasi harus menentukan di mana kode produk telah diinstal atau diiklankan.

Sintaksis

UINT MsiGetProductCodeA(
  [in]  LPCSTR szComponent,
  [out] LPSTR  lpBuf39
);

Parameter

[in] szComponent

Parameter ini menentukan kode komponen komponen yang telah diinstal oleh aplikasi. Ini biasanya akan menjadi kode komponen komponen yang berisi file aplikasi yang dapat dieksekusi.

[out] lpBuf39

Penunjuk ke buffer yang menerima kode produk. Panjang buffer ini harus 39 karakter. 38 karakter pertama adalah untuk GUID, dan karakter terakhir adalah untuk karakter null yang mengakhiri.

Mengembalikan nilai

Nilai	Arti
ERROR_BAD_CONFIGURATION	Data konfigurasi rusak.
ERROR_INSTALL_FAILURE	Kode produk tidak dapat ditentukan.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_SUCCESS	Fungsi berhasil diselesaikan.
ERROR_UNKNOWN_COMPONENT	Komponen yang ditentukan tidak diketahui.

Komentar

Selama inisialisasi, aplikasi harus menentukan kode produk tempat aplikasi diinstal. Aplikasi dapat menjadi bagian dari produk yang berbeda dalam penginstalan yang berbeda. Misalnya, aplikasi dapat menjadi bagian dari serangkaian aplikasi, atau dapat diinstal dengan sendirinya.

Nota

Header msi.h mendefinisikan MsiGetProductCode 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

Syarat	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 pada Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Platform Target	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Application-Only Functions

Bagikan melalui