Fungsi MsiGetProductInfoFromScriptA (msi.h)

Artikel
03/15/2023

Fungsi MsiGetProductInfoFromScript mengembalikan informasi produk untuk file skrip Pemasang Windows.

Sintaks

UINT MsiGetProductInfoFromScriptA(
  [in]      LPCSTR  szScriptFile,
  [out]     LPSTR   lpProductBuf39,
  [out]     LANGID  *plgidLanguage,
  [out]     LPDWORD pdwVersion,
  [out]     LPSTR   lpNameBuf,
  [in, out] LPDWORD pcchNameBuf,
  [out]     LPSTR   lpPackageBuf,
  [in, out] LPDWORD pcchPackageBuf
);

Parameter

[in] szScriptFile

String yang dihentikan null yang menentukan jalur lengkap ke file skrip. File skrip adalah skrip iklan yang dibuat dengan memanggil MsiAdvertiseProduct atau MsiAdvertiseProductEx.

[out] lpProductBuf39

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

[out] plgidLanguage

Menunjuk ke variabel yang menerima bahasa produk.

[out] pdwVersion

Menunjuk ke buffer yang menerima versi produk.

[out] lpNameBuf

Menunjuk ke buffer yang menerima nama produk. Buffer menyertakan karakter null yang dihentikan.

[in, out] pcchNameBuf

Menunjuk ke variabel yang menentukan ukuran, dalam karakter, dari buffer yang diacu oleh parameter lpNameBuf . Ukuran ini harus mencakup karakter null yang mengakhiri. Ketika fungsi kembali, variabel ini berisi panjang string yang disimpan dalam buffer. Jumlah yang dikembalikan tidak termasuk karakter null yang mengakhiri. Jika buffer tidak cukup besar, fungsi mengembalikan ERROR_MORE_DATA, dan variabel berisi ukuran string dalam karakter, tanpa menghitung karakter null.

[out] lpPackageBuf

Menunjuk ke buffer yang menerima nama paket. Buffer mencakup karakter null yang mengakhiri.

[in, out] pcchPackageBuf

Menunjuk ke variabel yang menentukan ukuran, dalam karakter, dari buffer yang diarahkan oleh parameter lpPackageNameBuf . Ukuran ini harus mencakup karakter null yang mengakhiri. Ketika fungsi kembali, variabel ini berisi panjang string yang disimpan dalam buffer. Jumlah yang dikembalikan tidak termasuk karakter null yang mengakhiri. Jika buffer tidak cukup besar, fungsi mengembalikan ERROR_MORE_DATA, dan variabel berisi ukuran string dalam karakter, tanpa menghitung karakter null.

Mengembalikan nilai

Nilai	Makna
ERROR_SUCCESS	Fungsi berhasil diselesaikan.
ERROR_INVALID_PARAMETER	Argumen yang tidak valid diteruskan ke fungsi.
ERROR_MORE_DATA	Buffer terlalu kecil untuk menahan seluruh nilai.
ERROR_INSTALL_FAILURE	Tidak bisa mendapatkan informasi skrip.
ERROR_CALL_NOT_IMPLEMENTED	Fungsi ini hanya tersedia di Windows 2000 dan Windows XP.

Keterangan

Catatan

Header msi.h mendefinisikan MsiGetProductInfoFromScript sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Pemasang Windows.
Target Platform	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Bagikan melalui