Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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(
  _In_ PCWSTR AppID
);

Parameters

AppID [in]

Type: PCWSTR

Pointer to the AppUserModelID to assign to the current process.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

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

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Shobjidl.h

Library

Shell32.lib

DLL

Shell32.dll (version 6.1 or later)

See also

Application User Model IDs (AppUserModelIDs)
GetCurrentProcessExplicitAppUserModelID
Taskbar Extensions

 

 

Community Additions

Show:
© 2015 Microsoft