MsiApplyPatchW 函数 （msi.h）
对于修补程序包列出的每个产品（符合接收修补程序的条件），MsiApplyPatch 函数将调用安装，并将 PATCH 属性设置为修补程序包的路径。
语法
UINT MsiApplyPatchW(
[in] LPCWSTR szPatchPackage,
[in] LPCWSTR szInstallPackage,
[in] INSTALLTYPE eInstallType,
[in] LPCWSTR 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 或具有 SP1 的 Windows XP 的安装程序。 有关详细信息，请参阅 安装多个产品和修补程序实例。 |
[in] szCommandLine
一个以 null 结尾的字符串，指定命令行属性设置。 请参阅命令行上
返回值
| 价值 | 意义 |
|---|---|
|
函数成功完成。 |
|
无法打开修补程序包。 |
|
修补程序包无效。 |
|
不支持修补程序包。 |
|
请参阅 错误代码。 |
| 出现初始化错误。 |
言论
由于转换、源和修补程序的列表分隔符是分号，因此不应将此字符用于文件名或路径。
应用 小更新 或 次要升级 修补程序时，必须在命令行上设置 REINSTALL 属性。 如果没有此属性，修补程序将注册到系统上，但无法更新文件。 对于不使用 自定义操作类型 51 自动设置 REINSTALL 和 REINSTALLMODE 属性的修补程序，必须使用 szCommandLine 参数显式设置 REINSTALL 属性。 将 REINSTALL 属性设置为列出受修补程序影响的功能，或使用实际默认设置“REINSTALL=ALL”。 REINSTALLMODE 属性的默认值为“omus”。 从 Windows Installer 版本 3.0 开始，重新安装 属性由安装程序配置，无需在命令行上设置。
注意
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 要求。 |
| 目标平台 | 窗户 |
| 标头 | msi.h |
| 库 | Msi.lib |
| DLL | Msi.dll |