Skip to main content

XStoreCreateContext

指定されたユーザーのストア コンテキストを作成します。

構文

パラメーター

user   _In_opt_
Type: XUserHandle
ストア コンテキストを作成するユーザー。
このパラメーターは PC ゲームでのみ省略可能です。単に nullptr 値を渡してください。PC では、Microsoft Store にサインインしているユーザーが自動的に使用され、このパラメーターは無視されます。 コンソール ゲームでは、有効な XUser が必要です。
storeContextHandle   _Out_
Type: XStoreContextHandle*
成功時に、作成されたストア コンテキストが格納されます。

戻り値

Type: HRESULT HRESULT の成功またはエラー コード。

解説

注: コンソールでは、この関数によって作成された XStoreContextHandle は、サスペンドまたはクイック リジューム イベントの後に無効になります。これらの状況を安全に処理するために、ゲームがサスペンド状態から再開するたびに XStoreContextHandle を閉じて再作成することをお勧めします。
この関数は、タイム センシティブなスレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブなスレッドを参照してください。
この関数によって作成された XStoreContextHandle の使用が終了したら、XStoreCloseContextHandle で閉じる必要があります。ハンドルを閉じないと、メモリ リークが発生します。ストア コンテキストは、多くの XStore API 呼び出しにおいて情報を取得する対象のユーザーを識別するために使用されます。次のコード スニペットは、ストア コンテキストを作成する例を示しています。

要件

ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One 本体および XBOX Series 本体

関連概念ドキュメント

関連項目

XStore
XStoreCloseContextHandle
XStoreRegisterGameLicenseChanged
最終更新日 2026年8月24日