msiRemovePatchesA 函式 (msi.h)

發行項
03/13/2024

MsiRemovePatches 函式會從單一產品中移除一或多個修補程式。若要從多個產品中移除修補程式，您必須為每個產品呼叫 MsiRemovePatches 。

語法

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

參數

[in] szPatchList

Null 終止的字串，表示要移除的修補程式清單。每個修補程式都可以由修補程式的 GUID 或修補程式套件的完整路徑指定。清單中的修補程式是以分號分隔。

[in] szProductCode

以 Null 終止的字串，這是移除修補程式之產品的 ProductCode (GUID) 。此參數不可為 NULL。

[in] eUninstallType

值，表示要執行的修補程式移除類型。此參數必須 INSTALLTYPE_SINGLE_INSTANCE。

值	意義
INSTALLTYPE_SINGLE_INSTANCE	修補程式只會針對 szProduct 所指定的產品卸載。

[in, optional] szPropertyList

指定命令行屬性設定的 Null 終止字串。如需詳細資訊，請參閱
關於屬性和在命令行上設定公用屬性值。此參數可以是 Null。

傳回值

MsiRemovePatches 函式會傳回下列值。

值	意義
ERROR_INVALID_PARAMETER	包含無效的參數。
ERROR_PATCH_PACKAGE_OPEN_FAILED	無法開啟修補程式套件。
ERROR_SUCCESS	已成功移除修補程式。
ERROR_UNKNOWN_PRODUCT	szProductList 指定的產品不會針對 MsiRemovePatches 的呼叫端安裝每部電腦或每個使用者。
ERROR_PATCH_PACKAGE_OPEN_FAILED	無法開啟修補程式套件。
ERROR_PATCH_PACKAGE_INVALID	修補程式套件無效。
ERROR_PATCH_PACKAGE_UNSUPPORTED	此版本的 Windows Installer 服務無法處理修補程式套件。
ERROR_PATCH_REMOVAL_UNSUPPORTED	修補程式套件不是卸除式套件。
ERROR_UNKNOWN_PATCH	修補程式尚未套用至此產品。
ERROR_PATCH_REMOVAL_DISALLOWED	原則不允許移除修補程式。

備註

如需示範應用程式如何從使用者可用的所有產品中移除修補程式的範例，請參閱卸載修補程式。

注意

msi.h 標頭會將 MsiRemovePatches 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。如需 Windows Installer 版本所需的最低 Windows Service Pack 相關信息，請參閱 Windows Installer Run-Time 需求。
目標平台	Windows
標頭	msi.h
程式庫	Msi.lib
Dll	Msi.dll