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