PatchMetadata 表 (PATCHWIZ.DLL)
PatchMetadata 表包含有关删除修补程序和添加/删除程序使用的Windows安装程序修补程序的信息。 PatchMetadata 表中的所有属性都添加到修补程序的 .msp 文件的 MsiPatchMetadata 表 。
修补程序创建属性文件 (.pcp 文件) 需要 PatchMetadata 表,该文件在 Properties 表中的 MinimumRequiredMsiVersion 等于 300。 如果 MinimumRequiredMsiVersion 不等于 300,则表是可选的。
PatchMetadata 表具有以下列。
列 | 类型 | 密钥 | Nullable |
---|---|---|---|
Company | 文本 | Y | Y |
属性 | 文本 | Y | N |
Value | 文本 | Y |
列
-
公司
-
公司的名称。 空字段 (Null 值) 指示此行包含标准元数据属性之一。 公司可以通过向表添加行并在此字段中输入公司名称来扩展属性集。
-
财产
-
元数据属性的名称。 PatchMetadata 表中需要 AllowRemoval、ManufacturerName、TargetProductName、MoreInfoURL、DisplayName、Description 和 Classification 属性。 如果“公司”字段为空 (Null 值) ,则此字段必须包含以下标准元数据属性之一。
属性 说明 AllowRemoval 一个整数值,该值指示修补程序是否为 可卸载修补程序。 如果 Value 字段包含 0 (零) ,则无法删除修补程序。 如果“值”字段包含 1 (一个) ,则修补程序为“可卸载修补程序”。 此属性是必需的。此属性已注册,可以使用 MsiGetPatchInfoEx 函数获取其值。 ManufacturerName 包含应用程序制造商名称的字符串值。 此属性是必需项。 MinorUpdateTargetRTM 指示修补程序面向产品的 RTM 版本或最新的主要升级修补程序。 在包含序列化信息的次要升级修补程序中创作此可选属性,以指示修补程序会删除到产品 RTM 版本或最新的主要升级修补程序的所有修补程序。 此属性从 Windows Installer 3.1 开始可用。 [!注意]
若要要求安装 Windows Installer 3.1 才能应用修补程序,请将 .pcp 文件的属性表中的 MinimumRequiredMsiVersion 属性设置为 310。TargetProductName 包含应用程序或目标应用程序套件名称的字符串值。 此属性是必需项。 MoreInfoURL 包含指向此修补程序信息的 URL 的字符串值。 注册此必需属性,并且可以使用 MsiGetPatchInfoEx 函数获取其值。 从 Service Pack 2 (SP2) Windows XP 开始,此值可以是“添加/删除程序”中显示的修补程序的支持链接。 CreationTimeUTC 一个字符串值,该值包含 .msp 文件的创建时间,格式为 mm-dd-yy HH:MM (month-day-year 小时:分钟) 。 此属性是可选的。 DisplayName 一个字符串值,该值包含适合公共显示的修补程序的标题。 此属性是必需项。 此属性已注册,可以使用 MsiGetPatchInfoEx 函数获取其值。 从 SP2 Windows XP 开始,此值是以 SP2 Windows XP 开头的“添加/删除程序”中显示的修补程序的名称。 说明 包含修补程序的简短说明的字符串值。 此属性是必需项。 分类 一个字符串值,该值包含由修补程序作者定义的任意更新类别。 例如,修补程序作者可以指定每个修补程序分类为修补程序、安全汇总、关键更新、更新、Service Pack 或更新汇总。 此属性是必需项。 OptimizedInstallMode 如果此属性设置为 1 (事务中要应用的所有修补程序中的一个) ,则尽可能优化修补程序的应用程序。 有关详细信息,请参阅 修补程序优化。 从 Windows Installer 3.1 开始可用。 -
价值
-
元数据属性的值。 这永远不能为 Null 或空字符串。 此值可以本地化。
注解
从 Windows Installer 3.0 开始提供。
所有创作到 PatchMetadata 表的属性都会添加到 msp 文件的 MsiPatchMetadata 表中。 AllowRemoval、MoreInfoURL 和 DisplayName 属性已注册,可通过 MsiGetPatchInfoEx 访问。