Metode Installer.ApplyPatch

Untuk setiap produk yang tercantum oleh paket patch sebagai memenuhi syarat untuk menerima patch, metode ApplyPatch objek Installer memanggil penginstalan dan mengatur properti PATCH ke jalur paket patch.

Sintaks

Installer.ApplyPatch(
  PatchPackage,
  InstallPackage,
  InstallType,
  CommandLine
)

Parameter

PatchPackage

Menentukan jalur ke paket patch.

InstallPackage

Jika InstallType diatur ke msiInstallTypeNetworkImage, InstallPackage menentukan jalur ke produk yang akan di-patch. Jika InstallType diatur ke msiInstallTypeDefault dan InstallPackage diatur ke 0, alat penginstal menerapkan patch ke setiap produk yang memenuhi syarat yang tercantum dalam paket patch.

Jika InstallType adalah msiInstallTypeSingleInstance, penginstal menerapkan patch ke produk yang ditentukan oleh InstallPackage. Dalam hal ini, produk lain yang memenuhi syarat yang tercantum dalam paket patch diabaikan dan parameter InstallPackage berisi string yang dihentikan null yang mewakili kode produk instans untuk di-patch. Jenis penginstalan ini memerlukan versi Pemasang Windows yang dikirim dengan Windows Server 2003 atau yang lebih baru atau Windows Installer XP SP1 atau yang lebih baru.

InstallType

Parameter ini menentukan jenis penginstalan yang akan di-patch. Parameter InstallType diabaikan jika InstallPackage dihilangkan.

Nilai Makna
msiInstallTypeNetworkImage
Menunjukkan penginstalan administratif. Dalam hal ini, InstallPackage harus diatur ke jalur paket. Nilai 1 untuk msiInstallTypeNetworkImage menentukan penginstalan administratif.
msiInstallTypeDefault
Mencari sistem untuk produk yang akan ditambal. Dalam hal ini, InstallPackage harus berupa string kosong.
msiInstallSingleInstance
Patch produk yang ditentukan oleh InstallPackage. InstallPackage adalah kode produk instans untuk di-patch. Jenis penginstalan ini memerlukan versi Pemasang Windows yang dikirim dengan Windows Server 2003 atau yang lebih baru atau Windows Installer XP SP1 atau yang lebih baru. Untuk informasi selengkapnya lihat, Menginstal Beberapa Instans Produk dan Patch.

 

CommandLine

Menentukan pengaturan properti yang sedang diatur pada baris perintah. Lihat bagian Keterangan.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Karena pemisah daftar untuk transformasi, sumber, dan patch adalah titik koma, karakter ini tidak boleh digunakan untuk nama atau jalur file.

Properti INSTAL ULANG diperlukan saat menerapkan pembaruan kecil atau patch peningkatan kecil . Tanpa properti ini, patch terdaftar pada sistem tetapi tidak dapat memperbarui file.

Windows Installer 2.0: Anda harus mengatur properti INSTAL ULANG pada baris perintah saat menerapkan pembaruan kecil atau patch peningkatan kecil . Untuk patch yang tidak menggunakan Tindakan Kustom Tipe 51 untuk secara otomatis mengatur properti INSTAL ULANG dan INSTAL ULANGMODE , properti INSTAL ULANG harus diatur secara eksplisit dengan parameter CommandLine . Atur properti INSTAL ULANG untuk mencantumkan fitur yang terpengaruh oleh patch, atau gunakan pengaturan default praktis "REINSTALL=ALL". Nilai default properti REINSTALLMODE adalah "omus".

Windows Installer 3.0 dan yang lebih baru: Dimulai dengan Penginstal Windows versi 3.0, properti INSTAL ULANG dikonfigurasi oleh alat penginstal dan tidak perlu diatur pada baris perintah.

Persyaratan

Persyaratan Nilai
Versi
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. Windows Installer 3.0 atau yang lebih baru pada Windows Server 2003 atau Windows XP.
DLL
Msi.dll
IID
IID_IInstaller didefinisikan sebagai 000C1090-0000-0000-C000-000000000046

Lihat juga

MsiApplyPatch

Tentang Properti

Tidak Didukung di Windows Installer 2.0 dan yang lebih lama