自定义操作类型 19
此自定义操作显示指定的错误消息,返回失败,然后终止安装。 显示的错误消息可以作为字符串或索引提供给 Error 表中。
源
将 CustomAction 表 的 Source 列留空。
类型值
在 CustomAction 表的 Type 列中包含以下值,以指定基本数值类型。
常量 | 十六进制 | 十进制 |
---|---|---|
msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile | 0x013 | 19 |
目标
CustomAction 表的 Target 列包含文本字符串,其格式是使用 MSIFormatRecord 中指定的功能(没有数值字段说明符)设置的。 要替换的参数用方括号 […] 括起来。,并且可以是属性、环境变量(% 前缀)、文件路径(# 前缀)或组件目录路径($ 前缀)。 如果在格式化字符串后计算结果为整数,该整数将用作 Error 表中的索引,以检索要显示的消息。 如果在格式化后,字符串后包含非数字字符,则字符串本身将显示为消息。
返回处理选项
自定义操作不使用任何选项。
执行计划选项
自定义操作不使用任何选项。
脚本内执行选项
自定义操作不使用任何选项。
返回值
请参阅自定义操作返回值。
备注
例如,自定义操作 CAError1、CAError2、CAError3 和 CAError4 返回下列消息。
操作 | 类型 | 源 | 目标 |
---|---|---|---|
CAError1 | 19 | [Prop1] | |
CAError2 | 19 | 错误 2 导致安装失败。 | |
CAError3 | 19 | 25000 | |
CAError4 | 19 | [Prop2] |
属性 | 值 |
---|---|
Prop1 | "错误 1 导致安装失败。" |
Prop2 | "25100" |
代码 | Message |
---|---|
25000 | 错误 3 导致安装失败。 |
25100 | 错误 4 导致安装失败。 |
这些自定义操作返回以下错误消息:
自定义操作 | 返回的消息字符串 |
---|---|
CAError1 | 错误 1 导致安装失败。 |
CAError2 | 错误 2 导致安装失败。 |
CAError3 | 错误 3 导致安装失败。 |
CAError4 | 错误 4 导致安装失败。 |
请注意,由于无法通过编写 LaunchCondition 表来保证启动条件的计算顺序,因此应在安装中使用自定义操作类型 19 自定义操作,以便按特定顺序计算条件。
相关主题