自定义操作类型 21

此自定义操作是用 JScript(例如 ECMA 262)编写的。 Windows Installer 不支持 JScript 1.0。 有关详细信息,请参阅脚本

脚本在当前会话期间随应用程序一起安装。 CustomAction 表的 Source 字段包含 File 表的键。 自定义操作代码的位置取决于此文件的目标路径的解析;因此,必须在安装文件之后和移除文件之前调用此自定义操作。

类型值

CustomAction 表的 Type 列中添加以下值,以指定 32 位自定义操作的基本数值类型。

常量 十六进制 十进制
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

 

Windows Installer 可以在 64 位操作系统上使用 64 位自定义操作。 基于脚本的 64 位自定义操作必须在其数值类型中包含 msidbCustomActionType64BitScript 位。 有关信息,请参阅“64 位自定义操作”。 在 CustomAction 表的 Type 列中包括以下值,以指定 64 位自定义操作的基本数值类型。

常量 十六进制 十进制
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

 

目标

CustomAction 表的 Target 字段包含可选的脚本函数。 处理将首先发送脚本进行解析,然后调用可选的脚本函数。

返回处理选项

CustomAction 表的 Type 列中添加可选标志位,以指定返回处理选项。 有关这些选项和值的说明,请参阅自定义操作返回处理选项

执行计划选项

CustomAction 表的 Type 列中包含可选标志位,以指定执行计划选项。 这些选项控制自定义操作的多次执行。 有关这些选项的说明,请参阅自定义操作执行计划选项

脚本内执行选项

CustomAction 表的 Type 列中添加可选标志位,以指定脚本内执行选项。 这些选项将操作代码复制到执行、回滚或提交脚本中。 有关这些选项的说明,请参阅自定义操作脚本内执行选项

返回值

采用脚本编写的可选函数必须返回 JScript 和 VBScript 自定义操作的返回值中所述的值之一。

备注

采用 JScript 或 VBScript 编写的自定义操作需要安装 Session 对象。 安装程序将 Session 对象附加到名为“Session”的脚本。 由于 Session 对象在安装回滚期间可能不存在,因此在脚本中编写的延迟自定义操作必须使用获取延迟执行自定义操作的上下文信息部分描述的 Session 对象的方法或属性之一来检索其上下文。

引用已安装文件作为其源的自定义操作(例如自定义操作类型 21 (JScript))必须遵守以下顺序限制:

  • 自定义操作必须排在 CostFinalize 操作之后。 这样自定义操作就可以解析定位源文件(其中包含 JScript)所需的路径。
  • 如果源文件尚未安装在计算机上,则必须将这种类型的延迟(脚本内)自定义操作排在 InstallFiles 操作之后。
  • 如果源文件尚未安装在计算机上,则必须将这种类型的非延迟自定义操作排在 InstallFinalize 操作之后。

Custom_Actions