大网数据广告活动
安装更新与部署

PATCH property

· 52CE 我爱测

The installer sets the PATCH property to a list of patches being applied by calling MsiApplyPatch, MsiApplyMultiplePatches or the /p Command Line Option.

The installer sets the PATCH property to a list of patches being applied by calling MsiApplyPatch, MsiApplyMultiplePatches or the /p Command Line Option. You can also set the PATCH property on the command line while installing a package using MsiInstallProduct or the /i Command Line Option.

The value of the PATCH property is a list of the patches that are being installed. Each patch in the list is represented by the full path to the patch's package (.msp file.) The full paths in the list are separated by semicolons.

Windows Installer 2.0: Multiple patches are not supported. Windows Installer 3.0 is required to apply multiple patches.

Remarks

If you create a patch package using Msimsp.exe and Patchwiz.dll you can specify that an action or a dialog box only run when a particular patch is being applied. When you create the patch package, for example test.msp, you author an upgraded image of the product and a patch creation properties file. When authoring the patch creation properties file you can enter a property name, for example PATCHFORTEST, in the MediaSrcPropName field of the ImageFamilies table. When you author the sequence tables of the upgraded image of the product, you can include in the Condition column of the sequence table a conditional statement for the action or dialog box you want to make conditional.

For example, you can use the following conditional statement to run an action or dialog box only when test.msp is being applied.

PATCH AND PATCHFORTEST AND PATCH >< PATCHFORTEST

Note:
Because the PATCH property can contain multiple patches, use the substring operator "><" to test for the presence of a particular patch rather than the equals operator "=". For more information about conditional statements see the Conditional Statement Syntax section.

The installer sets both properties if you apply a list of patches that includes test.msp. For example, you can use the /p Command Line Option to apply a list of two patches.

msiexec /qb /p \\scratch\scratch\XYZ\Patches\test.msp;\\scratch\scratch\XYZ\bar.msp

The installer sets the PATCH and PATCHFORTEST properties as follows.

PATCH=\\scratch\scratch\XYZ\Patches\test.msp;\\scratch\scratch\XYZ\bar.msp
PATCHFORTEST=\\scratch\scratch\XYZ\Patches\test.msp

In this case, the condition is TRUE and the above conditional action or dialog box can run for each patch being installed, test.msp and bar.msp.

If test.msp is not being applied, the installer does not include it in the PATCH property and does not set PATCHFORTEST. In this case, the condition above is FALSE and the conditional action or dialog box does not run.

Requirements

Requirement Value
Version Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.

See also

Properties

Conditional Statement Syntax

Examples of Conditional Statement Syntax

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。