IObjectWithAppUserModelID::GetAppID method (shobjidl_core.h)

Retrieves a file type handler's explicit Application User Model ID (AppUserModelID), if one has been declared.

Syntax

HRESULT GetAppID(
  [out] LPWSTR *ppszAppID
);

Parameters

[out] ppszAppID

Type: LPWSTR*

When this method returns, contains the address of the AppUserModelID string assigned to the object.

Return value

Type: HRESULT

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

Remarks

This method can only retrieve an AppUserModelID explicitly set for the handler. If the handler did not register an explicit AppUserModelID and is relying on a system-assigned AppUserModelID, this method will not retrieve the AppUserModelID. For more information, see Application User Model IDs (AppUserModelIDs).

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
Library Shell32.lib
DLL Shell32.dll (version 6.1 or later)

See also

Application User Model IDs (AppUserModelIDs)

IObjectWithAppUserModelID

IObjectWithAppUserModelID::SetAppID

Taskbar Extensions