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 版開始， 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 |