Fungsi MsiAdvertiseScriptA (msi.h)

Artikel
03/15/2023

Fungsi MsiAdvertiseScript menyalin file skrip yang diiklankan ke lokasi yang ditentukan.

Sintaks

UINT MsiAdvertiseScriptA(
  [in] LPCSTR szScriptFile,
  [in] DWORD  dwFlags,
  [in] PHKEY  phRegData,
  [in] BOOL   fRemoveItems
);

Parameter

[in] szScriptFile

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

[in] dwFlags

Bendera bit berikut dari iklan kontrol SCRIPTFLAGS. Nilai dwFlags dapat menjadi kombinasi dari nilai berikut.

Bendera	Makna
SCRIPTFLAGS_CACHEINFO 0x001	Sertakan bendera ini jika ikon perlu dibuat atau dihapus.
SCRIPTFLAGS_SHORTCUTS 0x004	Sertakan bendera ini jika pintasan perlu dibuat atau dihapus.
SCRIPTFLAGS_MACHINEASSIGN 0x008	Sertakan bendera ini jika produk yang akan ditetapkan ke komputer.
SCRIPTFLAGS_REGDATA_CNFGINFO 0x020	Sertakan bendera ini jika informasi konfigurasi dan manajemen dalam data registri perlu ditulis atau dihapus.
SCRIPTFLAGS_VALIDATE_TRANSFORMS_LIST 0x040	Sertakan bendera ini untuk memaksa validasi transformasi yang tercantum dalam skrip terhadap transformasi yang terdaftar sebelumnya untuk produk ini. Perhatikan bahwa konflik transformasi terdeteksi menggunakan perbandingan string yang tidak peka huruf besar/kecil dan dievaluasi antara penginstalan per pengguna dan per mesin di semua konteks. Jika daftar transformasi dalam skrip tidak cocok dengan transformasi yang terdaftar untuk produk, fungsi akan mengembalikan ERROR_INSTALL_TRANSFORM_FAILURE.
SCRIPTFLAGS_REGDATA_CLASSINFO 0x080	Sertakan bendera ini jika informasi iklan di registri yang terkait dengan kelas COM perlu ditulis atau dihapus.
SCRIPTFLAGS_REGDATA_EXTENSIONINFO 0x100	Sertakan bendera ini jika informasi iklan di registri yang terkait dengan ekstensi perlu ditulis atau dihapus.
SCRIPTFLAGS_REGDATA_APPINFO 0x180	Sertakan bendera ini jika informasi iklan dalam registri perlu ditulis atau dihapus.
SCRIPTFLAGS_REGDATA 0x1A0	Sertakan bendera ini jika informasi iklan dalam registri perlu ditulis atau dihapus.

[in] phRegData

Kunci registri di mana informasi sementara tentang data registri akan ditulis. Jika parameter ini null, data registri ditempatkan 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.

Perhatikan bahwa kunci registri ini tidak dapat digunakan saat membuat iklan produk untuk pengguna atau komputer karena penyedia kunci registri umumnya menghapus kunci. Kunci registri terletak di luar lokasi registri normal untuk informasi konfigurasi shell, kelas, dan .msi dan tidak berada di bawah HKEY_CLASSES_ROOT. Kunci registri ini hanya ditujukan untuk mendapatkan informasi sementara tentang data registri dalam skrip.

[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 hanya tersedia di Windows 2000 dan Windows XP.

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 MsiAdvertiseScript 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

Konteks Penginstalan

Bagikan melalui