Fungsi MsiAdvertiseProductExA (msi.h)
Fungsi MsiAdvertiseProductEx menghasilkan skrip iklan atau mengiklankan produk ke komputer. Fungsi ini memungkinkan Pemasang Windows untuk menulis ke skrip registri dan informasi pintasan yang digunakan untuk menetapkan atau menerbitkan produk. Skrip dapat ditulis agar konsisten dengan platform tertentu dengan menggunakan MsiAdvertiseProductEx. Fungsi MsiAdvertiseProductEx menyediakan fungsionalitas yang sama dengan MsiAdvertiseProduct.
Sintaks
UINT MsiAdvertiseProductExA(
[in] LPCSTR szPackagePath,
[in] LPCSTR szScriptfilePath,
[in] LPCSTR szTransforms,
[in] LANGID lgidLanguage,
[in] DWORD dwPlatform,
[in] DWORD dwOptions
);
Parameter
[in] szPackagePath
Jalur lengkap ke paket produk yang diiklankan.
[in] szScriptfilePath
Jalur lengkap ke file skrip yang akan dibuat dengan informasi yang diiklankan. Untuk mengiklankan produk secara lokal ke komputer, atur ADVERTISEFLAGS_MACHINEASSIGN atau ADVERTISEFLAGS_USERASSIGN.
[in] szTransforms
Daftar transformasi yang dibatasi titik koma yang akan diterapkan. Daftar transformasi dapat diawali dengan @ atau | karakter untuk menentukan penembolokan transformasi yang aman. Awalan @ menentukan transformasi sumber yang aman dan | awalan menunjukkan transformasi jalur penuh yang aman. Untuk informasi selengkapnya, lihat Transformasi Aman. Parameter ini mungkin null.
[in] lgidLanguage
Bahasa yang digunakan jika sumber mendukung beberapa bahasa.
[in] dwPlatform
Bendera bit yang mengontrol platform mana penginstal harus membuat skrip. Parameter ini diabaikan jika szScriptfilePath null. Jika dwPlatform adalah nol (0), maka skrip dibuat berdasarkan platform saat ini. Ini adalah fungsionalitas yang sama dengan MsiAdvertiseProduct. Jika dwPlatform adalah 1 atau 2, alat penginstal membuat skrip untuk platform yang ditentukan.
[in] dwOptions
Bendera bit yang menentukan opsi iklan tambahan. Nilai bukan nol hanya tersedia dalam versi Pemasang Windows yang dikirim dengan Windows Server 2003 dan Windows XP dengan SP1 dan yang lebih baru.
Bendera | Makna |
---|---|
|
Beberapa instans melalui kode produk yang mengubah bendera dukungan transformasi. Mengiklankan instans baru produk. Mengharuskan parameter szTransforms menyertakan transformasi instans yang mengubah kode produk. Untuk informasi selengkapnya, lihat Menginstal Beberapa Instans Produk dan Patch. |
Mengembalikan nilai
Nilai | Makna |
---|---|
|
Fungsi berhasil diselesaikan. |
|
Untuk informasi selengkapnya, lihat Kode Kesalahan. |
Terjadi kesalahan inisialisasi. | |
|
Kesalahan ini dikembalikan jika upaya dilakukan untuk menghasilkan skrip iklan di platform apa pun selain Windows 2000 atau Windows XP. Iklan ke komputer lokal didukung di semua platform. |
Keterangan
Beberapa instans melalui transformasi perubahan kode produk hanya tersedia untuk pengiriman versi Pemasang Windows dengan Windows Server 2003 dan Windows XP dengan SP1 dan yang lebih baru.
Catatan
Header msi.h mendefinisikan MsiAdvertiseProductEx 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 |