Fungsi MsiAdvertiseProductA (msi.h)

  • Artikel

Fungsi MsiAdvertiseProduct menghasilkan skrip iklan atau mengiklankan produk ke komputer. Fungsi MsiAdvertiseProduct memungkinkan penginstal 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.

Sintaks

UINT MsiAdvertiseProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage
);

Parameter

[in] szPackagePath

Jalur lengkap ke paket produk yang diiklankan.

[in] szScriptfilePath

Jalur lengkap ke file skrip yang akan dibuat dengan informasi iklan. Untuk mengiklankan produk secara lokal ke komputer, atur ADVERTISEFLAGS_MACHINEASSIGN atau ADVERTISEFLAGS_USERASSIGN.

Bendera Makna
ADVERTISEFLAGS_MACHINEASSIGN
0
 Atur untuk mengiklankan penginstalan per mesin produk 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 penginstalan yang digunakan jika sumber mendukung beberapa bahasa.

Mengembalikan nilai

Nilai Makna
ERROR_SUCCESS
 Fungsi berhasil diselesaikan.
Kesalahan yang berkaitan dengan tindakan
 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

Catatan

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

   
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