XLaunchUri
Microsoft GameCore Launcher API では、ゲームが URI を呼び出すことでエクスペリエンスを起動できるメカニズムが提供されます。
構文
HRESULT XLaunchUri(
XUserHandle requestingUser,
const char* uri
)
パラメーター
requestingUser _In_opt_
型: XUserHandle
要求を行うユーザーを示すハンドルを定義します。
uri _In_z_
型: char*
起動する URI を示す文字列。
戻り値
型: HRESULT
HRESULT 成功またはエラー コード。
正常に実行された場合は S_OK を返し、失敗した場合はエラー コードを返します。 エラー コードの一覧については、「エラー コード」を参照してください。
解説
注意
この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。
これは、ユーザーの代わりに URI を起動し、1 つのメソッド LaunchUri のみで構成されます。 また、オプションのユーザー コンテキストと必要な URI も受け取ります。
成功した場合は、対象の URI が起動されます。 それ以外の場合は、エラーが返されます。 このメソッドは、タイム クリティカルとは見なされず、基になる非同期システムの操作が完了し、対象の URI が起動されるか、またはエラーが発生するまで、ブロックされます。
指定された URI のプロトコル スキームを処理するアプリが存在しない場合、システムは、そのスキームを処理するアプリケーションを Microsoft Store で検索するかどうかをたずねるプロンプトを、ユーザーに表示します。
要件
ヘッダー: XLauncher.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体