Fungsi MsiAdvertiseProductExA (msi.h)

Artikel
11/20/2024

Fungsi MsiAdvertiseProductEx menghasilkan skrip iklan atau mengiklankan produk ke komputer. Fungsi ini memungkinkan Penginstal Windows menulis ke skrip informasi registri dan 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.

Sintaksis

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	Arti
ADVERTISEFLAGS_MACHINEASSIGN 0	Atur untuk mengiklankan penginstalan per komputer produk yang tersedia untuk semua pengguna.
ADVERTISEFLAGS_USERASSIGN 1	Atur untuk mengiklankan penginstalan per pengguna produk 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 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 alat 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	Arti
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 Penginstal Windows yang dikirim dengan Windows Server 2003 dan Windows XP dengan SP1 dan yang lebih baru.

Bendera	Arti
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	Arti
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.

Komentar

Beberapa instans melalui transformasi perubahan kode produk hanya tersedia untuk pengiriman versi Penginstal Windows dengan Windows Server 2003 dan Windows XP dengan SP1 dan yang lebih baru.

Nota

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

Penginstalan Multiple-Package

Tidak Didukung di Windows Installer 2.0 dan yang lebih lama

Bagikan melalui