Shell Functions


SetCurrentProcessExplicitAppUserModelID Function

Specifies a unique application-defined Application User Model ID (AppUserModelID) that identifies the current process to the taskbar. This identifier allows an application to group its associated processes and windows under a single taskbar button.

Syntax

HRESULT SetCurrentProcessExplicitAppUserModelID(      
    PCWSTR AppID );

Parameters

AppID
[in] Pointer to the AppUserModelID to assign to the current process.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method must be called during an application's initial startup routine before the application presents any user interface (UI) or makes any manipulation of its Jump Lists. This includes any call to SHAddToRecentDocs.

Function Information

Minimum DLL VersionShell32.dll version 6.1 or later
Custom ImplementationNo
Headershobjidl.h
Import libraryshell32.lib
Minimum operating systems Windows 7

See Also

Tags : windows7


Community Content

dalek9
Maximum length of 128?
    
  

Article  Introducing The Taskbar APIs
http://msdn.microsoft.com/en-us/magazine/dd942846.aspx
states:
    
The application ID is a string—not a GUID—that can take a free format of up to 128 characters.
    
If this is correct it would be nice to mention the maximum length in the documentation :)
    
Tags :

Page view tracker