IApplicationActivationManager::ActivateApplication メソッド (shobjidl_core.h)
現在のセッションの汎用起動コントラクト (Windows.Launch) に対して、指定された Windows ストア アプリをアクティブにします。
構文
HRESULT ActivateApplication(
[in] LPCWSTR appUserModelId,
[in] LPCWSTR arguments,
[in] ACTIVATEOPTIONS options,
[out] DWORD *processId
);
パラメーター
[in] appUserModelId
Windows ストア アプリのアプリケーション ユーザー モデル ID。
[in] arguments
省略可能なアプリ固有の引数文字列へのポインター。
[in] options
デザイン モード、デバッグ、テストのシナリオをサポートするために使用される次の 1 つ以上のフラグ。
AO_NONE (0x00000000)
フラグが設定されていません。
AO_DESIGNMODE (0x00000001)
アプリはデザイン モードでアクティブ化されているため、通常のウィンドウを作成できません。 アプリのウィンドウの作成は、アクティブ化マネージャーを介して確立されたサイト チェーン上のデザイナー指定のサービスと通信することによって、必要なコンポーネントを読み込むデザイン ツールによって行う必要があります。 これは、通常のアクティブ化中に表示されるスプラッシュ スクリーンが表示されない点に注意してください。
デザイン モードを正常に使用するには、アプリのパッケージでデバッグ モードを 有効にする 必要があることに注意してください。
AO_NOERRORUI (0x00000002)
アプリのアクティブ化に失敗した場合は、エラー ダイアログを表示しません。
AO_NOSPLASHSCREEN (0x00000004)
アプリがアクティブ化されている場合は、アプリのスプラッシュ スクリーンを表示しないでください。 このフラグを使用する場合は、アプリのパッケージで デバッグ モードを有効にする 必要があります。それ以外の場合、PLM は数秒後にアプリを終了します。
AO_PRELAUNCH (0x2000000)
アプリケーションは事前起動モードでアクティブ化されています。 この値は、Windows 10 以降でサポートされています。
[out] processId
このメソッドが正常に返されるときに、このコントラクトを満たすアプリ インスタンスのプロセス ID を受け取る値へのポインター。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |