PatchMetadata 表 (PATCHWIZ.DLL)

PatchMetadata 表包含有关移除修补程序所需的 Windows Installer 修补程序的信息,以及添加/移除程序所使用的修补程序。 PatchMetadata 表中的所有属性都会添加到修补程序的 .msp 文件的 MsiPatchMetadata 表中。

PatchMetadata 表在修补程序创建属性文件(.pcp)中是必需的,这些文件在 Properties 表中的 MinimumRequiredMSIVersion 等于 300。 如果 MinimumRequiredMsiVersion 不等于 300,则此表是可选的。

PatchMetadata 表包含以下列。

类型 密钥 Nullable
Company text Y Y
属性 text Y N
“值” text Y

 

Company

公司名称。 空字段(NULL 值)表示此行包含一个标准元数据属性。 公司可以通过向表中添加行并在此字段中输入公司名称来扩展属性集。

Property

元数据属性的名称。 PatchMetadata 表中需要 AllowRemoval、ManufacturerName、TargetProductName、MoreInfoURL、DisplayName、Description 和 Classification 属性。 如果 Company 字段为空(NULL 值),则此字段必须包含以下标准元数据属性之一。

属性 说明
AllowRemoval 一个整数值,该值指示修补程序是否为可卸载修补程序。 如果 Value 字段包含 0(零),则无法移除修补程序。 如果 Value 字段包含 1(一),则修补程序为可卸载修补程序。 此属性是必需的。此属性已注册,可以使用 MsiGetPatchInfoEx 函数获取其值。
ManufacturerName 一个字符串值,包含应用程序制造商名称。 此属性是必需项。
MinorUpdateTargetRTM 指示修补程序面向产品的 RTM 版本或最新的主要升级修补程序。 在包含排序信息的次要升级修补程序中创作此可选属性,以指示该修补程序移除产品的 RTM 版本之前的所有修补程序,或移除最新的主要升级修补程序。 此属性从 Windows Installer 3.1 开始提供。 注意: 若要要求安装 Windows Installer 3.1 以应用修补程序,请在 .pcp 文件的 “属性”表中 将 MinimumRequiredMsiVersion 属性设置为 310。
TargetProductName 一个字符串值,包含应用程序或目标应用程序套件的名称。 此属性是必需项。
MoreInfoURL 一个字符串值,包含指向修补程序信息的 URL。 此必需属性已注册,可以使用 MsiGetPatchInfoEx 函数获取其值。 从 Windows XP Service Pack 2 (SP2) 开始,此值可以是“添加/移除程序”中显示的修补程序的支持链接。
CreationTimeUTC 包含 .msp 文件的创建时间的字符串值,格式为 mm-dd-yy HH:MM (月-日-年 时:分)。 此属性是可选的。
DisplayName 一个字符串值,该值包含适合公开显示的修补程序的标题。 此属性是必需项。 此属性已注册,可以使用 MsiGetPatchInfoEx 函数获取其值。 从具有 SP2 的 Windows XP 开始,此值是“添加/移除程序”中显示的修补程序的名称。
说明 一个字符串值,该值包含修补程序的简要说明。 此属性是必需项。
分类 一个字符串值,该值包含由修补程序作者定义的任意类别的更新。 例如,修补程序作者可以指定每个修补程序分类为修补程序、安全汇总、关键更新、更新、Service Pack 或更新汇总。 此属性是必需项。
OptimizedInstallMode 如果在事务中要应用的所有修补程序中将此属性设置为 1(一),则会在可能的情况下优化修补程序的应用。 有关信息,请参阅修补程序优化。 从 Windows Installer 3.1 开始提供。

 

Value

元数据属性的值。 永远不能为 Null 或空字符串。 此值可以本地化。

备注

从 Windows Installer 3.0 开始可用。

编写到 PatchMetadata 表中的所有属性都将添加到 msp 文件的 MsiPatchMetadata 表中。 AllowRemoval、MoreInfoURL 和 DisplayName 属性已注册,可通过 MsiGetPatchInfoEx 进行访问。