IApplicationActivationManager::ActivateForFile method (shobjidl_core.h)

Activates the specified Windows Store app for the file contract (Windows.File).


HRESULT ActivateForFile(
  [in]  LPCWSTR         appUserModelId,
  [in]  IShellItemArray *itemArray,
  [in]  LPCWSTR         verb,
  [out] DWORD           *processId


[in] appUserModelId

The application user model ID of the Windows Store app.

[in] itemArray

A pointer to an array of Shell items, each representing a file. This value is converted to a VectorView of StorageItem objects that is passed to the app through FileActivatedEventArgs.

[in] verb

The verb being applied to the file or files specified by itemArray.

[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.


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