IApplicationActivationManager::ActivateForProtocol メソッド (shobjidl_core.h)

プロトコルコントラクト (Windows.Protocol) の指定した Windows ストアアプリをアクティブにします。

構文

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

[in] appUserModelId

Windows ストアアプリのアプリケーションユーザーモデル ID。

[in] itemArray

1 つのシェル項目の配列へのポインター。配列内の最初の項目は、 ProtocolActivatedEventArgs を介してアプリに渡される Uri オブジェクトに変換されます。配列内の最初の要素を除く項目はすべて無視されます。

[out] processId

このメソッドが正常に返されたときに、このコントラクトを満たすアプリインスタンスのプロセス ID を受け取る値へのポインター。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)