Shortcut 表

Shortcut 表包含应用程序在用户计算机上创建快捷方式所需的信息。

Shortcut 表包含以下列。

类型 密钥 Nullable
快捷键 Identifier Y N
Directory_ Identifier N N
名称 Filename N N
Component_ Identifier N N
目标 快捷方式 N N
参数 格式化 N Y
说明 文本 N Y
热键 整数 N Y
Icon_ Identifier N Y
IconIndex 整数 N Y
ShowCmd 整数 N Y
WkDir Identifier N Y
DisplayResourceDLL 格式化 N Y
DisplayResourceId 整数 N Y
DescriptionResourceDLL 格式化 N Y
DescriptionResourceId 整数 N Y

 

Shortcut

此表的密钥值。

Directory_

目录表第一列中的外部密钥。 此列指定创建 Shortcut 文件的目录。

Name

要创建的快捷方式的可本地化名称。

Component_

组件表第一列中的外部密钥。 安装程序使用此列中指定的组件的安装状态来确定是创建还是删除快捷方式。 此组件必须具有要安装的快捷方式的有效密钥路径。 如果 Target 列包含特征的名称,则快捷方式启动的文件即为此列中所列组件的密钥文件。

Target

快捷方式目标。

对于播发的快捷方式,此列必须是功能表第一列中的外部密钥。 安装程序将 Target 字段中的条目评估为标识符,并且该条目必须是功能表中的有效外部密钥。 本例中快捷方式启动的文件是 Component_ 列中所列组件的密钥文件。 激活快捷方式后,安装程序会在启动此文件之前验证是否已安装该功能中的所有组件。

对于非播发的快捷方式,安装程序将此字段评估为格式化字符串。 该字段应包含一个用方括号 ([ ]) 括起来的属性标识符,该标识符扩展到快捷方式指向的文件或文件夹。 有关详细信息,请参阅 CreateShortcuts 操作

Arguments

快捷方式的命令行参数。

请注意,Arguments 字段中属性的解析是受限的。 只有在安装了拥有谓词的组件的情况下属性已具有预期值时,才能解析此字段中格式为 [Property] 的属性。 例如,若要将参数“[#MyDoc.doc]”解析为正确的值,必须在同一过程中安装文件 MyDoc.doc 和拥有快捷方式的组件。

Description

快捷方式的可本地化说明。

Hotkey

快捷方式的热键。 低位字节包含键的虚拟键代码,高位字节包含修饰符标志。 这必须是非负数。 一般不建议安装包的作者设置这个选项,因为该选项的设置会在用户的桌面上添加重复的热键。 此外,将热键分配给快捷方式的做法可能会给使用热键来实现辅助功能的用户带来问题。

Icon_

图标表第一列的外部键。

IconIndex

快捷方式的图标索引。 这必须是非负数。

ShowCmd

应用程序窗口的 Show 命令。

可以使用以下值。 这些值与为 Windows API 函数 ShowWindow 定义的值一样。

含义
1 SW_SHOWNORMAL
3 SW_SHOWMAXIMIZED
7 SW_SHOWMINNOACTIVE

 

WkDir

具有快捷方式工作目录路径的属性的名称。 该值可以使用 Windows 格式引用环境变量,例如 %USERPROFILE%。 安装程序解析工作目录以创建快捷方式时,引用将解析为实际路径。

DisplayResourceDLL

此字段包含一个格式化字符串值,表示包含资源配置 (RC Config) 数据的语言中性可移植可执行文件(LN 文件)的完整路径。 该格式化字符串可以使用 [#filekey] 约定。 如果此字段包含值,则忽略 Name 列。 如果此字段为空,则安装程序将使用 Name 列中的值。 此字段包含值时,DisplayResourceId 字段也需要包含值,否则安装将失败。

Shortcut 表的这一列仅在 Windows Vista 或 Windows Server 2008 上使用,否则将被忽略。 此列适用于不低于 Windows Installer 4.0 的版本。

有关如何将快捷方式添加到 Shortcut 表以用于 MUI 资源的信息,请参阅 MUI 快捷方式示例

DisplayResourceId

快捷方式的显示名称索引。 这必须是非负数。 此字段包含值时,DisplayResourceDLL 字段也需要包含值,否则安装将失败。

Shortcut 表的这一列仅在 Windows Vista 或 Windows Server 2008 上使用,否则将被忽略。 此列适用于不低于 Windows Installer 4.0 的版本。

DescriptionResourceDLL

此字段包含一个格式化字符串值,表示包含资源配置 (RC Config) 数据的语言中性可移植可执行文件(LN 文件)的完整路径。 该格式化字符串可以使用 [#filekey] 约定。 如果此字段包含值,则忽略 Name 列。 如果此字段为空,安装程序将使用 Description 列中的值。 此字段包含值时,DescriptionResourceId 字段也需要包含值,否则安装将失败。

Shortcut 表的这一列仅在 Windows Vista 或 Windows Server 2008 上使用,否则将被忽略。 此列适用于不低于 Windows Installer 4.0 的版本。

有关如何将快捷方式添加到 Shortcut 表以用于 MUI 资源的信息,请参阅 MUI 快捷方式示例

DescriptionResourceId

快捷方式的说明名称索引。 这必须是非负数。 此字段包含值时,DescriptionResourceDLL 字段也需要包含值,否则安装将失败。

Shortcut 表的这一列仅在 Windows Vista 或 Windows Server 2008 上使用,否则将被忽略。 此列适用于不低于 Windows Installer 4.0 的版本。

备注

仅在系统的 IShellLink 接口支持安装程序描述符解析时,启用功能才会创建播发的快捷方式。 Microsoft Windows 2000 和运行 Microsoft Internet Explorer 4.01 的系统支持此功能。 如果此功能不受支持,安装程序会在安装功能组件(无论是在本地还是从源代码运行)时创建一个非播发的快捷方式。

请注意,播发的快捷方式始终指向特定应用程序,由 ProductCode 标识,并且不应在应用程序之间共享。 播发的快捷方式仅适用于最近安装的应用程序,并在该应用程序被删除的同时被删除。

执行 CreateShortcuts 操作RemoveShortcuts 操作时会引用此表。

另请参阅 DISABLEADVTSHORTCUTS 属性。

验证

ICE03
ICE06
ICE19
ICE32
ICE36
ICE46
ICE50
ICE57
ICE59
ICE67
ICE69
ICE80
ICE90
ICE91
ICE94