自定义作类型 21

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

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

类型值

CustomAction 表的 Type 列中包括以下值 以指定 32 位自定义作的基本数值类型。

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

 

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

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

 

目标

CustomAction 表的目标字段 包含可选脚本函数。 处理首先发送用于分析的脚本,然后调用可选的脚本函数。

返回处理选项

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

执行计划选项

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

In-Script 执行选项

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

返回值

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

言论

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

引用已安装文件的自定义作(如自定义作类型 21(JScript)必须遵循以下排序限制:

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

Custom_Actions