Fungsi MsiAdvertiseProductExA (msi.h)

  • Artikel

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.

Bendera Makna
ADVERTISEFLAGS_MACHINEASSIGN
0
 Atur untuk mengiklankan penginstalan produk per komputer yang tersedia untuk semua pengguna.
ADVERTISEFLAGS_USERASSIGN
1
 Atur untuk mengiklankan penginstalan produk per pengguna yang tersedia untuk pengguna tertentu.

[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.

Bendera Makna
Tidak ada
0
 Membuat skrip untuk platform saat ini.
MSIARCHITECTUREFLAGS_X86
1
 Membuat skrip untuk platform x86.
MSIARCHITECTUREFLAGS_IA64
2
 Membuat skrip untuk sistem berbasis Itanium.
MSIARCHITECTUREFLAGS_AMD64
4
 Membuat skrip untuk platform x64.

[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
MSIADVERTISEOPTIONS_INSTANCE
1
 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
ERROR_SUCCESS
 Fungsi berhasil diselesaikan.
Kesalahan yang berkaitan dengan tindakan
 Untuk informasi selengkapnya, lihat Kode Kesalahan.
Kesalahan Inisialisasi
 Terjadi kesalahan inisialisasi.
ERROR_CALL_NOT_IMPLEMENTED
 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

Lihat juga

Penginstalan Multi-Paket

Tidak Didukung di Windows Installer 2.0 dan yang lebih lama