System.AppUserModel.RelaunchCommand

Specifies a command that can be executed through ShellExecute to launch an application when it is pinned to the taskbar or when a new instance of the application is launched through the application's Jump List.

Examples include the following:

shell:::{ED228FDF-9EA8-4870-83B1-96B02CFE0D52}

virtualhost.exe /virtualapp:12345

notepad.exe

This property is used only if a window has an explicit Application User Model ID (AppUserModelID) (System.AppUserModel.ID, set through SHGetPropertyStoreForWindow). If the window does not have an explicit AppUserModelID, this property is ignored and the window is grouped and pinned as if it were part of the process that owns it. For more information about the application of explicit AppUserModelIDs and their effect on taskbar pinning, see Application User Model IDs (AppUserModelIDs).

This property is meant to be used by applications or windows that want to provide non-default relaunch information.

This property, together with System.AppUserModel.RelaunchDisplayNameResource and System.AppUserModel.RelaunchIconResource can be used to visually define a window as an application to the user. This is useful for host application scenarios, where a single host instance runs multiple child applications. For example, a virtual machine that hosts several virtualized applications might want those virtualized applications to appear as individual applications to the user. The virtual machine could label each window with an explicit AppUserModelID and the appropriate relaunch properties to make them appear as applications. The user could then pin them to the taskbar and "relaunch" the pinned instance.

To set this property on a window, use SHGetPropertyStoreForWindow to retrieve the window's property store, and use the methods of that retrieved IPropertyStore object to set the System.AppUserModel.RelaunchCommand property of that window.

Windows 10, version 1703, Windows 10, version 1607, Windows 10, version 1511, Windows 10, version 1507, Windows 8.1, Windows 8, Windows 7

propertyDescription
   name = System.AppUserModel.RelaunchCommand
   shellPKey = PKEY_AppUserModel_RelaunchCommand
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 2
   SearchInfo
      InInvertedIndex = false
      IsColumn = false
   typeInfo
      type = String
      IsInnate = false

Remarks

PKEY values are defined in Propkey.h.

Related topics

Application User Model IDs (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty