Skip to main content

XStoreAcquireLicenseForPackageAsync

ユーザーが使用する権限を持っている、現在のゲームのインストール済み DLC パッケージ (パッケージ付きの耐久型製品) のライセンスを取得します。 XStoreRegisterPackageLicenseLost を使用して、この API から取得したライセンスが失われたかどうかを監視できます。
この API は、パッケージのない耐久型アドオンでは動作しません。
パッケージのない耐久型のライセンスを取得するには、XStoreAcquireLicenseForDurablesAsync を使用します。

Syntax

Parameters

storeContextHandle   _In_
型: XStoreContextHandle
XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 packageIdentifier   _In_z_
型: char*
ストア パッケージを一意に識別する文字列。パッケージ識別子は通常、XPackageEnumeratePackages 操作の一部として返されます。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。 async   _Inout_
型: XAsyncBlock*
実行中の非同期作業を定義する XAsyncBlockXAsyncBlock を使用して呼び出しの状態をポーリングし、呼び出し結果を取得できます。詳細については、XAsyncBlock を参照してください。

Return value

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

Remarks

パッケージのライセンスとこの関数の実行結果を取得するには、この関数を呼び出した後に XStoreAcquireLicenseForPackageResult を呼び出します。 パッケージにライセンスを付与できるかどうかを確認するには、XStoreCanAcquireLicenseForPackageAsync を呼び出します。 ライセンスを取得した後、XStoreIsLicenseValid を呼び出してライセンスが有効かどうかを確認する必要があります。 XPackageMountWithUiAsync は呼び出されると自動的にライセンスを取得します。 ライセンスを取得できない場合、パッケージのマウントは失敗します。 このコード スニペットは、次の API の使用例を示しています。

Requirements

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

Conceptual documentation

See also

XStore
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
ダウンロード可能なコンテンツ (DLC) の管理およびライセンス
最終更新日 2026年8月24日