Skip to content

Latest commit

 

History

History
86 lines (65 loc) · 3.11 KB

nf-shobjidl_core-setcurrentprocessexplicitappusermodelid.md

File metadata and controls

86 lines (65 loc) · 3.11 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:shobjidl_core.SetCurrentProcessExplicitAppUserModelID
SetCurrentProcessExplicitAppUserModelID function (shobjidl_core.h)
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.
SetCurrentProcessExplicitAppUserModelID
SetCurrentProcessExplicitAppUserModelID function [Windows Shell]
_shell_SetCurrentProcessExplicitAppUserModelID
shell.SetCurrentProcessExplicitAppUserModelID
shobjidl_core/SetCurrentProcessExplicitAppUserModelID
shell\SetCurrentProcessExplicitAppUserModelID.htm
shell
2b8baf6d-9c9a-4727-9deb-3d335bd0dc7c
12/05/2018
SetCurrentProcessExplicitAppUserModelID, SetCurrentProcessExplicitAppUserModelID function [Windows Shell], _shell_SetCurrentProcessExplicitAppUserModelID, shell.SetCurrentProcessExplicitAppUserModelID, shobjidl_core/SetCurrentProcessExplicitAppUserModelID
shobjidl_core.h
Shobjidl.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Shell32.lib
Shell32.dll (version 6.1 or later)
Windows
19H1
SetCurrentProcessExplicitAppUserModelID
shobjidl_core/SetCurrentProcessExplicitAppUserModelID
c++
APIRef
kbSyntax
DllExport
Shell32.dll
API-MS-Win-DownLevel-shell32-l1-1-0.dll
ShCore.dll
API-MS-Win-ShCore-SysInfo-l1-1-0.dll
SetCurrentProcessExplicitAppUserModelID

SetCurrentProcessExplicitAppUserModelID function

-description

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.

-parameters

-param AppID [in]

Type: PCWSTR

Pointer to the AppUserModelID to assign to the current process.

-returns

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.

-see-also

Application User Model IDs (AppUserModelIDs)

GetCurrentProcessExplicitAppUserModelID

Taskbar Extensions