XStoreAcquireLicenseForPackageAsync
ユーザーが使用する権限を持っている、現在のゲームのインストール済み DLC パッケージ (パッケージ付きの耐久型製品) のライセンスを取得します。 XStoreRegisterPackageLicenseLost を使用して、この API から取得したライセンスが失われたかどうかを監視できます。この API は、パッケージのない耐久型アドオンでは動作しません。
Syntax
Parameters
storeContextHandle _In_型: XStoreContextHandle XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 packageIdentifier _In_z_
型: char* ストア パッケージを一意に識別する文字列。パッケージ識別子は通常、XPackageEnumeratePackages 操作の一部として返されます。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。 async _Inout_
型: XAsyncBlock* 実行中の非同期作業を定義する XAsyncBlock。XAsyncBlock を使用して呼び出しの状態をポーリングし、呼び出し結果を取得できます。詳細については、XAsyncBlock を参照してください。
Return value
型: HRESULT HRESULT の成功またはエラー コード。Remarks
パッケージのライセンスとこの関数の実行結果を取得するには、この関数を呼び出した後に XStoreAcquireLicenseForPackageResult を呼び出します。 パッケージにライセンスを付与できるかどうかを確認するには、XStoreCanAcquireLicenseForPackageAsync を呼び出します。 ライセンスを取得した後、XStoreIsLicenseValid を呼び出してライセンスが有効かどうかを確認する必要があります。 XPackageMountWithUiAsync は呼び出されると自動的にライセンスを取得します。 ライセンスを取得できない場合、パッケージのマウントは失敗します。 このコード スニペットは、次の API の使用例を示しています。- XStoreAcquireLicenseForPackageAsync
- XStoreAcquireLicenseForPackageResult
- XStoreIsLicenseValid
- XStoreCloseLicenseHandle
- XStoreRegisterPackageLicenseLost
- XStoreUnregisterPackageLicenseLost
Requirements
ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
ダウンロード可能なコンテンツ (DLC) の管理およびライセンス
