自定义操作类型 19

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

CustomAction 表 的 Source 列留空。

类型值

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

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

 

目标

CustomAction 表的 Target 列包含文本字符串,其格式是使用 MSIFormatRecord 中指定的功能(没有数值字段说明符)设置的。 要替换的参数用方括号 […] 括起来。,并且可以是属性、环境变量(% 前缀)、文件路径(# 前缀)或组件目录路径($ 前缀)。 如果在格式化字符串后计算结果为整数,该整数将用作 Error 表中的索引,以检索要显示的消息。 如果在格式化后,字符串后包含非数字字符,则字符串本身将显示为消息。

返回处理选项

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

执行计划选项

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

脚本内执行选项

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

返回值

请参阅自定义操作返回值

备注

例如,自定义操作 CAError1、CAError2、CAError3 和 CAError4 返回下列消息。

CustomAction 表

操作 类型 目标
CAError1 19 [Prop1]
CAError2 19 错误 2 导致安装失败。
CAError3 19 25000
CAError4 19 [Prop2]

 

Property 表

属性
Prop1 "错误 1 导致安装失败。"
Prop2 "25100"

 

错误表

代码 Message
25000 错误 3 导致安装失败。
25100 错误 4 导致安装失败。

 

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

自定义操作 返回的消息字符串
CAError1 错误 1 导致安装失败。
CAError2 错误 2 导致安装失败。
CAError3 错误 3 导致安装失败。
CAError4 错误 4 导致安装失败。

 

请注意,由于无法通过编写 LaunchCondition 表来保证启动条件的计算顺序,因此应在安装中使用自定义操作类型 19 自定义操作,以便按特定顺序计算条件。

Custom_Actions