2.2.1.20.1 Element-Specific Attributes

  • Article

Attribute name

Description

action

(optional) If specified, the value MUST be C, D, R, or U, corresponding to Create, Delete, Replace, and Update. If unspecified, the default value is U.

  • Create: This action MUST be used to create a new shortcut for computers or users.

  • Delete: This action MUST be used to remove a shortcut for computers or users.

  • Replace: This action MUST be used to delete and re-create a shortcut for computers or users. The net result of the Replace action is to overwrite the existing shortcut. If the shortcut does not exist, then the Replace action creates a new shortcut.

  • Update: This action MUST be used to modify the settings of an existing shortcut for computers or users. This action differs from Replace in that it updates only shortcut settings defined within the preference item. All other settings remain as configured in the shortcut. If the shortcut does not exist, then the Update action creates a new shortcut.

pidl

(optional) A fully qualified item list specifying the location of a selected folder. For information on the pointer to an item identifier list (PIDL) data type, see [MSDN-EXPLORER].

shortcutPath

MUST be a display name for the shortcut.

targetType

MUST be the type of target to which the shortcut will point. MUST be one of FILESYSTEM, URL, or SHELL.

targetPath

MUST be a local path, UNC path, or drive letter to which the shortcut will lead, a URL to which the shortcut will lead, or the shell object (such as a printer, file, folder, share, computer, network resource, or desktop or control panel item) to which the shortcut will lead.

arguments

(optional) MUST be the arguments to use when opening the target file or folder. This option applies only if targetType is set to FILESYSTEM and the action is Create, Replace, or Update.

startIn

(optional) MUST specify a working directory. Do not include quotation marks or a trailing slash. This option applies only if targetType is set to FILESYSTEM and the action is Create, Replace, or Update.

shortcutKey

(optional) Provides a keyboard shortcut for launching the shortcut. This value MUST be a key combination. This option applies only if the action is Create, Replace, or Update.

window

(optional) MUST be the size of the window in which to open the target of the shortcut. This option applies only if targetType is set to FILESYSTEM or SHELL and the action is Create, Replace, or Update.

comment

(optional) Displays a tooltip when the mouse pointer pauses on the shortcut. This value MUST be the text for the tooltip. This option applies only if targetType is set to FILESYSTEM or SHELL, and the action is Create, Replace, or Update.

iconPath

(optional) MUST be the path to a file that contains an icon resource.

iconIndex

(optional) MUST be the resource ID of an icon stored in the file that iconPath points to.