Skip to main content

XStoreQueryLicenseTokenAsync

呼び出し元のゲームに、エンタイトルメントの検証や B2B 呼び出しを行うためにゲームのサービスに渡すことができる、不透明な JSON Web トークンを提供します。詳細については、ライセンス トークンの概要を参照してください。

構文

パラメーター

storeContextHandle   _In_
Type: XStoreContextHandle
XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 productIds   _In_z_count_(productIdsCount)
Type: char**
トークンを取得する対象の製品 ID の配列。 productIdsCount   _In_
Type: size_t
productIds に渡される配列内の ID の数。 customDeveloperString   _In_z_
Type: char*
トークンにラウンド トリップされる値。これは通常サービスによって選択されます。userId や電子メールなどを挿入することで、ライセンス トークン内のユーザーのトークンを追跡できます。ライセンス トークンは所有権の受領証のように使用されます。 これは null または空の文字列にすることはできません。 async   _Inout_
Type: XAsyncBlock*
実行中の非同期処理を定義する XAsyncBlockXAsyncBlock は、呼び出しの状態のポーリングと呼び出し結果の取得に使用できます。詳細については、XAsyncBlock を参照してください。

戻り値

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

解説

JSON Web トークンとこの関数の実行結果を取得するには、この関数を呼び出した後に XStoreQueryLicenseTokenResult を呼び出します。JSON Web トークンのサイズを取得するには、この関数を呼び出した後に XStoreQueryLicenseTokenResultSize を呼び出します。トークンのサイズを事前に知ることで、より効率的に取得できます。 ライセンス トークンは Base64 エンコードされた JSON Web トークンです。トークンのペイロードは Base64 エンコードされた文字列で、サーバー上で検証に使用できる JSON 値に変換されます。 次のコード スニペットは、ライセンス トークンを取得する例を示しています。

要件

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

関連概念ドキュメント

関連項目

XStore ライセンス トークンの概要 XStoreQueryLicenseTokenResult XStoreQueryLicenseTokenResultSize
最終更新日 2026年8月28日