Fungsi MsiProcessAdvertiseScriptA (msi.h)

Artikel
08/24/2023

Fungsi MsiProcessAdvertiseScript memproses file skrip iklan ke lokasi yang ditentukan.

Sintaks

UINT MsiProcessAdvertiseScriptA(
  [in] LPCSTR szScriptFile,
  [in] LPCSTR szIconFolder,
  [in] HKEY   hRegData,
  [in] BOOL   fShortcuts,
  [in] BOOL   fRemoveItems
);

Parameter

[in] szScriptFile

Jalur lengkap ke file skrip yang dihasilkan oleh MsiAdvertiseProduct atau MsiAdvertiseProductEx.

[in] szIconFolder

Jalur opsional ke folder tempat file ikon yang diiklankan dan file transformasi berada. Jika parameter ini NULL, tidak ada ikon atau file transformasi yang ditulis.

[in] hRegData

Kunci registri tempat data registri akan ditulis. Jika parameter ini NULL, alat penginstal menulis data registri di bawah kunci yang sesuai, berdasarkan apakah iklan tersebut per pengguna atau per mesin. Jika parameter ini non-NULL, skrip akan menulis data registri di bawah kunci registri yang ditentukan daripada lokasi normal. Dalam hal ini, aplikasi tidak akan diiklankan kepada pengguna.

[in] fShortcuts

TRUE jika pintasan harus dibuat. Jika folder khusus dikembalikan oleh SHGetSpecialFolderLocation , folder tersebut akan menahan pintasan.

[in] fRemoveItems

TRUE jika item yang ditentukan akan dihapus alih-alih dibuat.

Nilai kembali

Nilai	Makna
ERROR_SUCCESS	Fungsi berhasil diselesaikan.
ERROR_ACCESS_DENIED	Proses panggilan tidak berjalan di bawah akun LocalSystem.
Kesalahan yang berkaitan dengan tindakan	Lihat Kode Kesalahan.
Kesalahan Inisialisasi	Terjadi kesalahan terkait inisialisasi.
ERROR_CALL_NOT_IMPLEMENTED	Fungsi ini tidak tersedia untuk platform ini.

Keterangan

Proses yang memanggil fungsi ini harus berjalan di bawah akun LocalSystem. Untuk mengiklankan aplikasi untuk penginstalan per pengguna kepada pengguna yang ditargetkan, utas yang memanggil fungsi ini harus meniru pengguna yang ditargetkan. Jika utas yang memanggil fungsi ini tidak meniru pengguna yang ditargetkan, aplikasi diiklankan ke semua pengguna untuk penginstalan dengan hak istimewa yang ditingkatkan.

Catatan

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