SHARDAPPIDINFOLINK structure (shlobj_core.h)

Contains data used by SHAddToRecentDocs to identify both an item, in this case through an IShellLink, and the process that it is associated with.

Syntax

typedef struct SHARDAPPIDINFOLINK {
  IShellLink *psl;
  PCWSTR     pszAppID;
} SHARDAPPIDINFOLINK;

Members

psl

Type: IShellLink*

Pointer to an IShellLink instance that, when launched, opens the item. The shortcut is not added by SHAddToRecentDocs to the user's Recent folder (CSIDL_RECENT, FOLDERID_Recent), but it is added to the Recent category in the specified application's Jump List.

pszAppID

Type: PCWSTR

The application-defined AppUserModelID associated with the item.

Remarks

The IShellLink instance pointed to by psl must provide the following:

• Either a pointer to an item identifier list (PIDL) (IShellLink::SetIDList) or the target path (IShellLink::SetPath or IShellLink::SetRelativePath)
• Command-line arguments (IShellLink::SetArguments)
• Icon location (IShellLink::SetIconLocation)

The display name must be set through the item's System.Title (PKEY_Title) property. The property can directly hold the display name or it can be an indirect string representation, such as "@shell32.dll,-1324", to use a stored string. An indirect string enables the item name to be displayed in the user's selected language.

Optionally, the description field (IShellLink::SetDescription) can be set to provide a custom tooltip for the item in the Jump List.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	shlobj_core.h (include Shlobj.h)

See also

Application User Model IDs (AppUserModelIDs)

SHARDAPPIDINFO

SHARDAPPIDINFOIDLIST

SHAddToRecentDocs