The external key into the first column of the Directory table. This column specifies the directory in which the Shortcut file is created.
Name
The localizable name of the shortcut to be created.
Component_
The external key into the first column of the Component table. The installer uses the installation state of the component specified in this column to determine whether the shortcut is created or deleted. This component must have a valid key path for the shortcut to be installed. If the Target column contains the name of a feature, the file launched by the shortcut is the key file of the component listed in this column.
Target
The shortcut target.
For an advertised shortcut, this column must be an external key into the first column of the Feature table. The installer evaluates the entry in the Target field as an Identifier and the entry must be a valid foreign key into the Feature Table. The file launched by the shortcut in this case is the key file of the component listed in the Component_ column. When the shortcut is activated, the installer verifies that all the components in the feature are installed before launching this file.
For a non-advertised shortcut, the installer evaluates this field as a Formatted string. The field should contains a property identifier enclosed by square brackets ([ ]), that is expanded into the file or a folder pointed to by the shortcut. For more information, see the CreateShortcuts action.
Arguments
The command-line arguments for the shortcut.
Note that the resolution of properties in the Arguments field is limited. A property formatted as [Property] in this field can only be resolved if the property already has the intended value when the component that owns the shortcut is installed. For example, to resolve to the correct value for the argument "[#MyDoc.doc]", the same process must be installing the file MyDoc.doc and the component that owns the shortcut.
Description
The localizable description of the shortcut.
Hotkey
The hotkey for the shortcut. The low-order byte contains the virtual-key code for the key, and the high-order byte contains modifier flags. This must be a non-negative number. Authors of installation packages are generally recommended not to set this option, because the setting of this option can add duplicate hotkeys to a user's desktop. In addition, the practice of assigning hotkeys to shortcuts can be problematic for users using hotkeys for accessibility.
The icon index for the shortcut. This must be a non-negative number.
ShowCmd
The Show command for the application window.
The following values may be used. The values are as defined for the Windows API function ShowWindow.
Value
Meaning
1
SW_SHOWNORMAL
3
SW_SHOWMAXIMIZED
7
SW_SHOWMINNOACTIVE
WkDir
The name of the property that has the path of the working directory for the shortcut. The value can use the Windows format to reference environment variables, for example %USERPROFILE%. The references are resolved to an actual path when the installer resolves the working directory to create the shortcut.
DisplayResourceDLL
This field contains a Formatted string value for the full path to the language-neutral portable executable (LN file) that contains the resource configuration (RC Config) data. The formatted string can use the [#filekey] convention. If this field contains a value, the Name column is ignored. If this field is empty, the installer uses the value in the Name column. When this field contains a value, the DisplayResourceId field is also required to contain a value, or the installation fails.
This column of the Shortcut table is used only when running on Windows Vista or Windows Server 2008 and is otherwise ignored. This column is available with versions not earlier than Windows Installer 4.0.
For information about how to add shortcuts to Shortcut table for use with MUI resources see A MUI Shortcut Example.
DisplayResourceId
The display name index for the shortcut. This must be a non-negative number. When this field contains a value, the DisplayResourceDLL field is required to also contain a value or the installation fails.
This column of the Shortcut table is used only when running on Windows Vista or Windows Server 2008 and is otherwise ignored. This column is available with versions not earlier than Windows Installer 4.0.
DescriptionResourceDLL
This field contains a Formatted string value for the full path to the language-neutral portable executable (LN file) that contains the resource configuration (RC Config) data. The formatted string can use the [#filekey] convention. If this field contains a value, the Name column is ignored. If this field is empty, the installer uses the value in the Description column. When this field contains a value, the DescriptionResourceId field is also required to contain a value, or the installation fails.
This column of the Shortcut table is used only when running on Windows Vista or Windows Server 2008 and is otherwise ignored. This column is available with versions not earlier than Windows Installer 4.0.
For information about how to add shortcuts to Shortcut table for use with MUI resources see A MUI Shortcut Example.
DescriptionResourceId
The description name index for the shortcut. This must be a non-negative number. When this field contains a value, the DescriptionResourceDLL field is required to also contain a value or the installation fails.
This column of the Shortcut table is used only when running on Windows Vista or Windows Server 2008 and is otherwise ignored. This column is available with versions not earlier than Windows Installer 4.0.
Remarks
The enabling of a feature creates an advertised shortcut only if the system's IShellLink interface supports installer descriptor resolution. This is supported by Microsoft Windows 2000 and systems running Microsoft Internet Explorer 4.01. If unsupported, the installer creates a non-advertised shortcut upon the installation of the feature's component, either locally or run from source.
Note that advertised shortcuts always point at a particular application, identified by a ProductCode, and should not be shared between applications. Advertised shortcuts only work for the most recently installed application, and are removed when that application is removed.
The Identifier data type is a text string. Identifiers may contain the ASCII characters A-Z (a-z), digits, underscores (\_), or periods (.). However, every identifier must begin with either a letter or an underscore.
The Property table contains the property names and values for all defined properties in the installation. Properties with Null values are not present in the table.
The installer sets the DesktopFolder property to the full path of the current user's Desktop folder. If an &\#0034;All Users&\#0034; profile exists and the ALLUSERS property is set, then this property is set to the folder in the &\#0034;All Users&\#0034; profile.
Setting the DISABLEADVTSHORTCUTS property disables the generation of shortcuts supporting installation-on-demand and advertisement. Setting this property specifies that these shortcuts should instead be replaced by regular shortcuts.