IObjectWithAppUserModelID::SetAppID method (shobjidl_core.h)

Specifies a unique application-defined Application User Model ID (AppUserModelID) that identifies the object as a handler for a specific file type. This method is used by applications that require dynamic AppUserModelIDs.

Syntax

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Parameters

[in] pszAppID

Type: LPCWSTR

A pointer to the AppUserModelID string to assign to an application.

Return value

Type: HRESULT

Custom implementations that do not require dynamic AppUserModelIDs can return E_NOTIMPL. Custom implementations that require dynamic AppUserModelIDs should return S_OK if successful, or an error value otherwise.

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::GetAppID

SetCurrentProcessExplicitAppUserModelID

Taskbar Extensions