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) |