Fungsi MsiApplyMultiplePatchesA (msi.h)

Artikel
11/20/2024

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

Sintaksis

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

Parameter

[in] szPatchPackages

Daftar jalur yang dibatasi titik koma untuk menambal file 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 ProductCode GUID 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 null-terminated yang menentukan pengaturan properti baris perintah yang digunakan selama patching produk. Jika tidak ada pengaturan properti baris perintah, teruskan penunjuk NULL. String kosong adalah parameter yang tidak valid. Properti ini dibagikan oleh semua produk target. Untuk 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.

Mengembalikan nilai

Fungsi MsiApplyMultiplePatches mengembalikan nilai berikut.

Nilai	Arti
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 yang 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 menghentikan panggilan ini ke MsiApplyMultiplePatches. Semua produk target mungkin belum di-patch.
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.

Komentar

Nota

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

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