Specifies a unique Application User Model ID (AppUserModelID) for the application from whose taskbar button's Jump List the methods of this interface will remove destinations. This method is optional.
HRESULT SetAppID( LPCWSTR pszAppID );
Pointer to the AppUserModelID of the process whose taskbar button representation receives the Jump List.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
After an AppUserModelID is specified through an object's SetAppID method, the AppUserModelID is saved in the object for that object's lifetime, providing that it is not overwritten by another call to SetAppID.
Some applications will not declare an explicit AppUserModelID and should not call this method. In that case, the application's identity is deduced when IApplicationDestinations::RemoveDestination or IApplicationDestinations::RemoveAllDestinations are called. However, there is a performance benefit in avoiding those calculations, so applications that provide custom Jump Lists are encouraged to use explicit AppUserModelIDs.
|Minimum supported client||Windows 7 [desktop apps only]|
|Minimum supported server||Windows Server 2008 R2 [desktop apps only]|
|Header||shobjidl_core.h (include Shobjidl.h)|
|DLL||Shell32.dll (version 6.1 or later)|