IApplicationActivationManager::ActivateForProtocol method

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

Syntax

HRESULT ActivateForProtocol(
  LPCWSTR         appUserModelId,
  IShellItemArray *itemArray,
  DWORD           *processId
);

Parameters

appUserModelId

The application user model ID of the Windows Store app.

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.

processId

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

Return value

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

Requirements

   
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