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
此參數指定要修補的安裝類型。
| 安裝類型 | 意義 |
|---|---|
|
指定系統管理安裝。 在此情況下，szInstallPackage 必須設定為封裝路徑。 INSTALLTYPE_NETWORK_IMAGE的 值為 1，會針對系統管理安裝設定此值。 |
|
搜尋系統以尋找要修補的產品。 在此情況下，szInstallPackage 必須是 0。 |
|
修補 szInstallPackage所指定的產品。 szInstallPackage 是要修補之實例的原始程式碼。 這種類型的安裝需要執行 Windows Server 2003 或 Windows XP SP1 的安裝程式。 如需詳細資訊，請參閱 安裝多個產品和修補程式實例。 |
[in] szCommandLine
指定命令行屬性設定的 Null 終止字串。 請參閱命令列上的關於 屬性 和 設定公用屬性值。 請參閱一節。
傳回值
| 價值 | 意義 |
|---|---|
|
函式已順利完成。 |
|
無法開啟修補程式套件。 |
|
修補程式套件無效。 |
|
不支援修補程式套件。 |
|
請參閱 |
| 發生初始化錯誤。 |
言論
因為轉換、來源和修補程式的清單分隔符是分號，因此不應該將此字元用於檔名或路徑。
在套用 小型更新 或 次要升級 修補程式時，您必須在命令行上設定 REINSTALL 屬性。 如果沒有這個屬性，修補程式就會在系統上註冊，但無法更新檔案。 對於不使用 自定義動作類型 51 來自動設定 REINSTALL 和 REINSTALLMODE 属性的修補程式，您必須使用 szCommandLine 參數明確設定 REINSTALL 屬性。 設定 REINSTALL 屬性來列出修補程式影響的功能，或使用實際的預設設定 “REINSTALL=ALL”。 REINSTALLMODE 屬性的預設值為 “omus”。 從 Windows Installer 3.0 版開始，安裝程式會設定 REINSTALL 屬性，而且不需要在命令行上設定。
注意
msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiApplyPatch 定義為自動選取此函式的 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 需求。 |
| 目標平臺 | 窗戶 |
| 標頭 | msi.h |
| 連結庫 | Msi.lib |
| DLL | Msi.dll |