Skip to main content

XLaunchUri

Microsoft Game Development Kit (GDK) Launcher API は、URI を呼び出すことでゲームがエクスペリエンスを起動できるメカニズムを提供します。

Syntax

Parameters

requestingUser   _In_opt_
型: XUserHandle
要求を行うユーザーを識別するハンドルを定義します。 uri   _In_z_
型: char*
起動する URI を示す文字列。

Return value

型: HRESULT HRESULT の成功またはエラー コード。 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。エラー コードの一覧については、Error Codes を参照してください。

Remarks

この関数は、タイム センシティブ スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
これは URI を介して別のアプリを起動します。また、オプションのユーザー コンテキストと必須の URI を受け入れます。 成功した場合、宛先の URI が起動されます。それ以外の場合はエラーが返されます。このメソッドはタイム クリティカルとは見なされず、基盤となる非同期システム操作が完了して、宛先の URI が起動されるかエラーが発生するまでブロックされます。 指定された URI のプロトコル スキームを処理するアプリが存在しない場合、システムは、そのスキームを処理するアプリケーションを Windows ストアで検索するかどうかをユーザーに尋ねるプロンプトを表示します。

バックグラウンドでの起動

コンソールでは、appxmanifest ファイルに backgroundMediaPlayback 機能を持つユニバーサル Windows アプリを、フォアグラウンドではなくバックグラウンドで起動できます。これを行うには、URI に “ms-bgm-” という文字列を先頭に付加します。たとえば、バックグラウンド メディア アプリケーションがプロトコル “companion-music-app://” に応答する場合、URI “ms-bgm-companion-music-app://” でバックグラウンドに起動できます。アプリがアクティブ化を受信するとき、ProtocolActivatedEventArgs から取得した URI には “ms-bgm-” プレフィックスは含まれません。 この方法で呼び出した場合、適切なアプリがインストールされていないときに、XLaunchUri はユーザーにプロンプトを表示しません。代わりに、ゲームが GDK の 2025 年 4 月版以降を使用している場合は、E_GAMEPACKAGE_NO_PACKAGE_IDENTIFIER を返します。コードでこの戻り値をチェックし、必要に応じてユーザーに修復 UI を表示するために使用できます。 PC では、この方法で XLaunchUri を呼び出すと、URI の先頭から単に “ms-bgm-” を削除して、通常どおり起動します。PC 上のシステム動作に他の影響はありません。 以下は、コンパニオン ミュージック アプリケーションを起動するために XLaunchUri を呼び出す例です。

Requirements

ヘッダー: XLauncher.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

概念ドキュメント

See also

XLauncher
最終更新日 2026年8月24日