Fungsi MsiApplyMultiplePatchesA (msi.h)

Artikel
08/24/2023

Fungsi MsiApplyMultiplePatches menerapkan satu atau beberapa patch ke produk yang memenuhi syarat untuk menerima patch. Fungsi MsiApplyMultiplePatches menetapkan properti PATCH dengan daftar patch yang dibatasi oleh titik koma dan memanggil patching produk target. Properti lain dapat diatur menggunakan daftar properti.

Sintaks

UINT MsiApplyMultiplePatchesA(
  [in]           LPCSTR szPatchPackages,
  [in, optional] LPCSTR szProductCode,
  [in, optional] LPCSTR szPropertiesList
);

Parameter

[in] szPatchPackages

Daftar jalur yang dibatasi titik koma ke file patch sebagai string tunggal. Misalnya: ""c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp" "

[in, optional] szProductCode

Parameter ini adalah GUID ProductCode dari produk yang akan di-patch. Pengguna atau aplikasi yang memanggil MsiApplyMultiplePatches harus memiliki hak istimewa untuk menerapkan patch. Ketika parameter ini NULL, patch diterapkan ke semua produk yang memenuhi syarat. Ketika parameter ini non-NULL, patch hanya diterapkan ke produk yang ditentukan.

[in, optional] szPropertiesList

String yang dihentikan null yang menentukan pengaturan properti baris perintah yang digunakan selama patching produk. Jika tidak ada pengaturan properti baris perintah, berikan penunjuk NULL . String kosong adalah parameter yang tidak valid. Properti ini dibagikan oleh semua produk target. Untuk mengetahui informasi selengkapnya, lihat
Tentang Properti dan Mengatur Nilai Properti Publik pada Baris Perintah.

Catatan Daftar properti tidak boleh berisi properti PATCH . Jika properti PATCH diatur di baris perintah, nilai diabaikan dan ditimpa dengan patch yang diterapkan.

Menampilkan nilai

Fungsi MsiApplyMultiplePatches mengembalikan nilai berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Beberapa argumen yang diteruskan salah atau bertentangan.
ERROR_SUCCESS	Fungsi selesai dan semua produk berhasil di-patch. ERROR_SUCCESS dikembalikan hanya jika semua produk yang memenuhi syarat untuk patch berhasil di-patch. Jika tidak ada patch baru yang berlaku, MsiApplyMultiplePatches mengembalikan ERROR_SUCCESS dan status produk tetap tidak berubah.
ERROR_SUCCESS_REBOOT_INITIATED	Mulai ulang dimulai oleh transaksi terakhir mengakhiri panggilan ini ke MsiApplyMultiplePatches. Semua produk target mungkin belum di-patch.
ERROR_SUCCESS_REBOOT_REQUIRED	Mulai ulang yang diperlukan oleh transaksi terakhir mengakhiri panggilan ini ke MsiApplyMultiplePatches. Semua produk target mungkin belum ditambal.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Salah satu paket patch yang disediakan tidak dapat dibuka.
ERROR_PATCH_PACKAGE_INVALID	Salah satu paket patch yang disediakan bukan paket yang valid.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Salah satu paket patch tidak didukung.
Kesalahan apa pun di Winerror.h	Menyiratkan kemungkinan penyelesaian parsial atau bahwa satu atau beberapa transaksi gagal.

Keterangan

Catatan

Header msi.h mendefinisikan MsiApplyMultiplePatches sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Target Platform	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll