Fungsi MsiAdvertiseScriptW (msi.h)

Artikel
11/20/2024

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

Sintaksis

UINT MsiAdvertiseScriptW(
  [in] LPCWSTR 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	Arti
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 dalam registri yang terkait dengan kelas COM perlu ditulis atau dihapus.
SCRIPTFLAGS_REGDATA_EXTENSIONINFO 0x100	Sertakan bendera ini jika informasi iklan dalam 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.

Mengembalikan nilai

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

Komentar

Proses yang memanggil fungsi ini harus berjalan di bawah akun LocalSystem. Untuk mengiklankan aplikasi untuk penginstalan per pengguna ke 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.

Nota

Header msi.h mendefinisikan MsiAdvertiseScript sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Konteks Penginstalan

Bagikan melalui