Skip to main content

XStoreCanAcquireLicenseForStoreIdAsync

パッケージの有無を問わず耐久型製品や、現在挿入されているディスク上のコンテンツなど、ライセンス付与可能なコンテンツのプレビュー ライセンスを取得します。 この API により、ゲームは実際にライセンスを取得することなく、その製品がライセンス付与可能かどうかを確認できます。

Syntax

Parameters

storeContextHandle   _In_
型: XStoreContextHandle
XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 storeProductId   _In_z_
型: char*
確認する製品の StoreID。 async   _Inout_
型: XAsyncBlock*
実行中の非同期作業を定義する XAsyncBlockXAsyncBlock を使用して呼び出しの状態をポーリングし、呼び出し結果を取得できます。 詳細については、XAsyncBlock を参照してください。

Return value

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

Remarks

XStoreCanAcquireLicenseForStoreIdAsync は、ゲームが実際にライセンスを取得してそのユーザーの同時使用スロットを消費せずに、ユーザーが特定のコンテンツのライセンスを取得できるかどうかを判定する機能をゲームに提供します。 現在実行中のゲームは既にライセンスを持っているため、この関数を使用する必要はありませんが、ユーザーが同じ発行元の他のゲームやコンテンツを所有しているかどうかを判定できます。 たとえば、ゲームはこの API を使用して、ゲームの以前のバージョン (デジタルまたは挿入されたディスクから) を所有しているユーザーに報酬を提供するかどうか、またはユーザーに製品をアップセルするかどうかを判定できます。 プレビュー ライセンスとこの関数の実行結果を取得するには、この関数を呼び出した後に XStoreCanAcquireLicenseForStoreIdResult を呼び出します。 このコード スニペットは、次の API の使用例を示しています。

Requirements

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

Conceptual documentation

See also

XStore
XStoreCanAcquireLicenseForStoreIdResult
パッケージなしの耐久型を使用する方法
プレイヤーへのアドオン コンテンツへのアクセス許可の付与
最終更新日 2026年8月24日