快捷表

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

快捷表包含以下列。

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

 

快捷方式

此表的键值。

Directory_

目录 的第一列的外部键。 此列指定在其中创建快捷方式文件的目录。

名字

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

Component_

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

目标

快捷目标。

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

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

参数

快捷方式的命令行参数。

请注意,参数字段中属性解析有限。 只有在安装了拥有快捷方式的组件时,才能解析此字段中格式为 [Property] 的属性。 例如,若要解析为参数“[#MyDoc.doc]”的正确值,同一进程必须安装文件MyDoc.doc以及拥有快捷方式的组件。

描述

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

热键

快捷方式的热键。 低顺序字节包含密钥的虚拟键代码,高顺序字节包含修饰符标志。 这必须是非负数。 通常建议不要设置此选项的安装包作者,因为此选项的设置可以将重复的热键添加到用户的桌面。 此外,将热键分配给快捷方式的做法对于使用热键进行 辅助功能的用户可能会有问题。

Icon_

图标表之一列的外部键。

IconIndex

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

ShowCmd

应用程序窗口的“显示”命令。

可以使用以下值。 这些值是针对 Windows API 函数 ShowWindow 定义的。

含义
1 SW_SHOWNORMAL
3 SW_SHOWMAXIMIZED
7 SW_SHOWMINNOACTIVE

 

WkDir

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

DisplayResourceDLL

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

仅当在 Windows Vista 或 Windows Server 2008 上运行时,才使用此快捷方式表的列,否则将被忽略。 此列适用于低于 Windows Installer 4.0 的版本。

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

DisplayResourceId

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

仅当在 Windows Vista 或 Windows Server 2008 上运行时,才使用此快捷方式表的列,否则将被忽略。 此列适用于低于 Windows Installer 4.0 的版本。

DescriptionResourceDLL

此字段包含非特定语言的可移植可执行文件的完整路径 的格式字符串值 (,) 包含资源配置 (RC Config) 数据。 格式化字符串可以使用 [#filekey] 约定。 如果此字段包含一个值,则忽略 Name 列。 如果此字段为空,安装程序将使用“说明”列中的值。 当此字段包含一个值时,还需要 DescriptionResourceId 字段才能包含值,否则安装会失败。

仅当在 Windows Vista 或 Windows Server 2008 上运行时,才使用此快捷方式表的列,否则将被忽略。 此列适用于低于 Windows Installer 4.0 的版本。

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

DescriptionResourceId

快捷方式的说明名称索引。 这必须是非负数。 当此字段包含一个值时,需要 DescriptionResourceDLL 字段才能包含值或安装失败。

仅当在 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