通过

自定义作类型 19

  • 项目

此自定义作显示指定的错误消息，返回失败，然后终止安装。 显示的错误消息可以作为字符串提供，也可以作为索引提供给 错误表。

源

将 customAction 表的“源”列保留为空。

类型值

在 CustomAction 表的 Type 列中包括以下值，以指定基本数值类型。

常数 十六进制 十进制
msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile 0x013 19

 

目标

CustomAction 表的目标列 包含使用 MsiFormatRecord 中指定的功能设置格式的文本字符串（不包含数值字段说明符）。 要替换的参数括在方括号中，}可以是属性、环境变量（% 前缀）、文件路径（# 前缀）或组件目录路径（$ 前缀）。 如果在设置字符串的格式后计算结果为整数，该整数将用作 错误表中的索引， 检索要显示的消息。 如果在设置字符串格式后包含非数字字符，字符串本身将显示为消息。

返回处理选项

自定义作不使用任何选项。

执行计划选项

自定义作不使用任何选项。

In-Script 执行选项

自定义作不使用任何选项。

返回值

请参阅 自定义作返回值。

言论

例如，自定义作 CAError1、CAError2、CAError3 和 CAError4 返回这些消息。

CustomAction 表

行动 类型 源 目标
CAError1 19 [Prop1]
CAError2 19 由于错误 2 而导致安装失败。
CAError3 19 25000
CAError4 19 [Prop2]

 

属性表

财产 价值
Prop1 “由于错误 1 而安装失败。”
Prop2 "25100"

 

错误表

法典 消息
25000 安装失败，原因为 Error3。
25100 由于错误 4 而导致安装失败。

 

这些自定义作返回以下错误消息：

自定义作 返回的消息字符串
CAError1 安装失败，原因为 Error1。
CAError2 由于错误 2 而导致安装失败。
CAError3 安装失败，原因为 Error3。
CAError4 由于错误 4 而导致安装失败。

 

请注意，由于无法通过创作 LaunchCondition 表来保证对启动条件的评估顺序，因此应在安装中使用自定义作类型 19 自定义作来按特定顺序评估条件。

Custom_Actions