IApplicationActivationManager::ActivateForProtocol method (shobjidl_core.h)

Activates the specified Windows Store app for the protocol contract (Windows.Protocol).

Syntax

HRESULT ActivateForProtocol(
  [in]  LPCWSTR         appUserModelId,
  [in]  IShellItemArray *itemArray,
  [out] DWORD           *processId
);

Parameters

[in] appUserModelId

The application user model ID of the Windows Store app.

[in] itemArray

A pointer to an array of a single Shell item. The first item in the array is converted into a Uri object that is passed to the app through ProtocolActivatedEventArgs. Any items in the array except for the first element are ignored.

[out] processId

A pointer to a value that, when this method returns successfully, receives the process ID of the app instance that fulfills this contract.

Return value

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

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also

IApplicationActivationManager