msiApplyPatchA 函式 (msi.h)

  • 發行項

針對修補程式套件所列出的每個產品，符合接收修補程序的資格， MsiApplyPatch 函式會叫用安裝，並將 PATCH 屬性設定為修補程式套件的路徑。

語法

UINT MsiApplyPatchA(
  [in] LPCSTR      szPatchPackage,
  [in] LPCSTR      szInstallPackage,
  [in] INSTALLTYPE eInstallType,
  [in] LPCSTR      szCommandLine
);

參數

[in] szPatchPackage

以 Null 結尾的字串，指定修補程式套件的完整路徑。

[in] szInstallPackage

如果 eInstallType 設定為 INSTALLTYPE_NETWORK_IMAGE，則此參數為 null 終止的字串，指定要修補之產品的路徑。 如果 szInstallPackage 設定為 null，且 eInstallType 設定為 INSTALLTYPE_DEFAULT，安裝程式會將修補程式套用至修補程式套件中列出的每個合格產品。

如果 eInstallType 是INSTALLTYPE_SINGLE_INSTANCE，安裝程式會將修補程式套用至 szInstallPackage 所指定的產品。 在此情況下，會忽略修補程式套件中列出的其他合格產品， 而 szInstallPackage 參數包含 Null 終止的字元串，代表要修補之實例的產品代碼。 這種類型的安裝需要執行 Windows Server 2003 或 Windows XP 的安裝程式。

[in] eInstallType

此參數會指定要修補的安裝類型。

安裝類型 意義
INSTALLTYPE_NETWORK_IMAGE
 指定系統管理安裝。 在此情況下， szInstallPackage 必須設定為封裝路徑。 INSTALLTYPE_NETWORK_IMAGE的 值為 1，會針對系統管理安裝設定此值。
INSTALLTYPE_DEFAULT
 搜尋系統以尋找要修補的產品。 在此情況下， szInstallPackage 必須為 0。
INSTALLTYPE_SINGLE_INSTANCE
 修補 szInstallPackage 所指定的產品。 szInstallPackage 是要修補之實例的產品代碼。 這種類型的安裝需要執行 Windows Server 2003 或 Windows XP SP1 的安裝程式。 如需詳細資訊，請參閱 安裝多個產品實例和修補程式。

[in] szCommandLine

指定命令行屬性設定的 Null 終止字串。 請參閱命令行上的關於 屬性 和 設定公用屬性值。 請參閱＜備註＞一節。

傳回值

值 意義
ERROR_SUCCESS
 語言函式已順利完成。
ERROR_PATCH_PACKAGE_OPEN_FAILED
 無法開啟修補程式套件。
ERROR_PATCH_PACKAGE_INVALID
 修補程式套件無效。
ERROR_PATCH_PACKAGE_UNSUPPORTED
 不支援修補程式套件。
與動作相關的錯誤
 請參閱 錯誤碼。
初始化錯誤
 發生初始化錯誤。

備註

因為轉換、來源和修補程式的清單分隔符是分號，所以不應該將此字元用於檔名或路徑。

注意  

套用小型更新或次要升級修補程式時，您必須在命令行上設定 REINSTALL 屬性。 如果沒有這個屬性，修補程式就會在系統上註冊，但無法更新檔案。 對於不使用自定義動作類型 51 來自動設定 REINSTALL 和 REINSTALLMODE 屬性的修補程式，必須以 szCommandLine 參數明確設定 REINSTALL 屬性。 設定 REINSTALL 屬性以列出修補程式所影響的功能，或使用實際的預設設定 “REINSTALL=ALL”。 REINSTALLMODE 屬性的預設值為 “omus”。 從 Windows Installer 3.0 版開始， INSTALLER 屬性是由安裝程式設定，不需要在命令行上設定。

 

注意

msi.h 標頭會將 MsiApplyPatch 定義為別名，根據 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 Server 2003 或 Windows XP 上的 Windows Installer。 如需 Windows Installer 版本所需的最低 Windows Service Pack 相關信息，請參閱 Windows Installer Run-Time 需求。
目標平台 Windows
標頭 msi.h
程式庫 Msi.lib
Dll Msi.dll

另請參閱

錯誤碼

初始化錯誤

多重套件安裝

Windows Installer 2.0 和更早版本中不支援