Fungsi MsiRemovePatchesA (msi.h)

Artikel
11/20/2024

Fungsi MsiRemovePatches menghapus satu atau beberapa patch dari satu produk. Untuk menghapus patch dari beberapa produk, MsiRemovePatches harus dipanggil untuk setiap produk.

Sintaksis

UINT MsiRemovePatchesA(
  [in]           LPCSTR      szPatchList,
  [in]           LPCSTR      szProductCode,
  [in]           INSTALLTYPE eUninstallType,
  [in, optional] LPCSTR      szPropertyList
);

Parameter

[in] szPatchList

String yang dihentikan null yang mewakili daftar patch yang akan dihapus. Setiap patch dapat ditentukan oleh GUID patch atau jalur lengkap ke paket patch. Patch dalam daftar dibatasi oleh titik koma.

[in] szProductCode

String null-terminated yang merupakan ProductCode (GUID) produk tempat patch dihapus. Parameter ini tidak dapat null.

[in] eUninstallType

Nilai yang menunjukkan jenis penghapusan patch yang akan dilakukan. Parameter ini harus INSTALLTYPE_SINGLE_INSTANCE.

Nilai	Arti
INSTALLTYPE_SINGLE_INSTANCE	Patch dihapus instalannya hanya untuk produk yang ditentukan oleh szProduct.

[in, optional] szPropertyList

String null-terminated yang menentukan pengaturan properti baris perintah. Untuk informasi selengkapnya, lihat
Tentang Properti dan Mengatur Nilai Properti Publik pada baris perintah. Parameter ini dapat null.

Mengembalikan nilai

Fungsi MsiRemovePatches mengembalikan nilai berikut.

Nilai	Arti
ERROR_INVALID_PARAMETER	Parameter yang tidak valid disertakan.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Paket patch tidak dapat dibuka.
ERROR_SUCCESS	Patch berhasil dihapus.
ERROR_UNKNOWN_PRODUCT	Produk yang ditentukan oleh szProductList tidak diinstal baik per mesin atau per pengguna untuk pemanggil MsiRemovePatches.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Paket patch tidak dapat dibuka.
ERROR_PATCH_PACKAGE_INVALID	Paket patch tidak valid.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Paket patch tidak dapat diproses oleh versi layanan Windows Installer ini.
ERROR_PATCH_REMOVAL_UNSUPPORTED	Paket patch tidak dapat dilepas.
ERROR_UNKNOWN_PATCH	Patch belum diterapkan ke produk ini.
ERROR_PATCH_REMOVAL_DISALLOWED	Penghapusan patch tidak diizinkan oleh kebijakan.

Komentar

Lihat Menghapus instalasi Patch untuk contoh yang menunjukkan bagaimana aplikasi dapat menghapus patch dari semua produk yang tersedia untuk pengguna.

Nota

Header msi.h mendefinisikan MsiRemovePatches 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