GetCurrentProcessExplicitAppUserModelID function
Applies to: desktop apps only
Retrieves the application-defined, explicit Application User Model ID (AppUserModelID) for the current process.
Syntax
HRESULT GetCurrentProcessExplicitAppUserModelID( __out PWSTR *AppID );
Parameters
- AppID [out]
-
Type: PWSTR*
A pointer that receives the address of the AppUserModelID assigned to the process. The caller is responsible for freeing this string with CoTaskMemFree when it is no longer needed.
Return value
Type: HRESULT
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
The AppUserModelID retrieved by this function was set earlier through SetCurrentProcessExplicitAppUserModelID.
An application can only retrieve an AppUserModelID that has been explicitly set. System-assigned default AppUserModelIDs cannot be retrieved. If the application requires knowledge of its AppUserModelID it should set one explicitly.
Requirements
|
Minimum supported client | Windows 7 |
|---|---|
|
Minimum supported server | Windows Server 2008 R2 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 3/7/2012
