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

[アーティクル]
08/26/2023

現在のセッションの汎用起動コントラクト (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 を含む)

こちらもご覧ください

IApplicationActivationManager

IPackageDebugSettings::EnableDebugging