Fungsi MsiGetProductInfoExW (msi.h)

Fungsi MsiGetProductInfoEx mengembalikan informasi produk untuk produk yang diiklankan dan diinstal. Fungsi ini dapat mengambil informasi

tentang instans produk yang diinstal di bawah akun pengguna selain pengguna saat ini.

Proses panggilan harus memiliki hak administratif untuk pengguna yang berbeda dari pengguna saat ini. Fungsi MsiGetProductInfoEx tidak dapat meminta instans produk yang diiklankan di bawah konteks per pengguna yang tidak dikelola untuk akun pengguna selain pengguna saat ini.

Fungsi ini adalah ekstensi fungsi MsiGetProductInfo.

Sintaksis

UINT MsiGetProductInfoExW(
  [in]                LPCWSTR           szProductCode,
  [in]                LPCWSTR           szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                LPCWSTR           szProperty,
  [out, optional]     LPWSTR            szValue,
  [in, out, optional] LPDWORD           pcchValue
);

Parameter

[in] szProductCode

ProductCode GUID instans produk yang sedang dikueri.

[in] szUserSid

Pengidentifikasi keamanan (SID) akun tempat instans produk yang sedang dikueri ada. NULL menentukan SID pengguna saat ini.

[in] dwContext

Konteks penginstalan instans produk yang sedang dikueri.

[in] szProperty

Properti sedang dikueri.

Properti yang akan diambil. Properti dalam tabel berikut ini hanya dapat diambil dari aplikasi yang sudah diinstal. Semua properti yang diperlukan dijamin tersedia, tetapi properti lain hanya tersedia jika properti diatur. Untuk informasi selengkapnya, lihat
Properti yang Diperlukan dan properti .

Untuk mengambil ID produk, pemilik terdaftar, atau perusahaan terdaftar dari aplikasi yang diinstal, atur szProperty ke salah satu nilai string teks berikut.

Untuk mengambil jenis instans produk, atur szProperty ke nilai berikut. Properti ini tersedia untuk produk yang diiklankan atau diinstal.

Properti dalam tabel berikut dapat diambil dari aplikasi yang diiklankan atau diinstal. Properti ini tidak dapat diambil untuk instans produk yang diinstal di bawah konteks per pengguna yang tidak dikelola untuk akun pengguna selain akun pengguna saat ini.

[out, optional] szValue

Penunjuk ke buffer yang menerima nilai properti. Buffer ini harus cukup besar untuk berisi informasi. Jika buffer terlalu kecil, fungsi mengembalikan ERROR_MORE_DATA dan mengatur *pcchValue ke jumlah TCHAR dalam nilai, tidak termasuk karakter NULL yang mengakhiri.

Jika lpValue diatur ke NULL dan pcchValue diatur ke pointer yang valid, fungsi mengembalikan ERROR_SUCCESS dan mengatur *pcchValue ke jumlah TCHAR dalam nilai, tidak termasuk karakter NULL yang mengakhiri. Fungsi kemudian dapat dipanggil lagi untuk mengambil nilai , dengan lpValue buffer yang cukup besar untuk berisi *pcchValue + 1 karakter.

Jika lpValue dan pcchValue keduanya diatur ke NULL, fungsi mengembalikan ERROR_SUCCESS jika nilai ada, tanpa mengambil nilai.

[in, out, optional] pcchValue

Penunjuk ke variabel yang menentukan jumlah TCHAR dalam buffer lpValue . Ketika fungsi kembali, parameter ini diatur ke ukuran nilai yang diminta apakah fungsi menyalin nilai ke dalam buffer yang ditentukan atau tidak. Ukuran dikembalikan sebagai jumlah TCHAR dalam nilai yang diminta, tidak termasuk karakter null yang mengakhiri.

Parameter ini dapat diatur ke null hanya jika lpValue juga NULL. Jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Mengembalikan nilai

Fungsi MsiGetProductInfoEx mengembalikan nilai berikut.

Komentar

Saat fungsi MsiGetProductInfoEx kembali, parameter pcchValue berisi panjang string yang disimpan dalam buffer. Jumlah yang dikembalikan tidak menyertakan karakter null yang dihentikan. Jika buffer tidak cukup besar, MsiGetProductInfoEx mengembalikan ERROR_MORE_DATA, dan parameter pcchValue berisi ukuran string, dalamTCHAR , tanpa menghitung karakter null.

Fungsi MsiGetProductInfoEx (INSTALLPROPERTY_LOCALPACKAGE) mengembalikan jalur ke paket yang di-cache. Paket cache hanya untuk penggunaan internal. Penginstalan mode pemeliharaan harus dipanggil melalui fungsi MsiConfigureFeature, MsiConfigureProduct, atau MsiConfigureProductEx.

Fungsi MsiGetProductInfo mengembalikan ERROR_UNKNOWN_PROPERTY jika aplikasi yang dikueri diiklankan dan tidak diinstal. Misalnya, jika aplikasi diiklankan dan tidak diinstal, kueri untuk INSTALLPROPERTY_INSTALLLOCATION mengembalikan kesalahan ERROR_UNKNOWN_PROPERTY.

Persyaratan

Lihat juga

ARPHELPLINK

ARPHELPTELEPHONE

ARPINSTALLLOCATION

ARPPRODUCTICON

ARPURLINFOABOUT

ARPURLUPDATEINFO

Produsen

MsiConfigureFeature

MsiConfigureProduct

MsiConfigureProductEx

Tidak Didukung di Windows Installer 2.0 dan yang lebih lama

Kode Paket

ProductCode

ProductID

ProductName

ProductVersion

Properti

Properti yang Diperlukan

SourceDir

Fungsi Status Sistem