自定义作类型 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