XStoreAcquireLicenseForDurablesAsync
パッケージなしの非消費型アイテムまたは非消費型アドオン製品のライセンスを取得します。
注意
この API は、パッケージ付きの非消費型製品の種類では機能しません。 パッケージ付きの非消費型に対してこの API を呼び出そうとすると、XStoreAcquireLicenseForDurablesResult はエラーを返します。 パッケージ付きの非消費型のライセンスを取得するには、XStoreAcquireLicenseForPackageAsync を使用します。
構文
HRESULT XStoreAcquireLicenseForDurablesAsync(
const XStoreContextHandle storeContextHandle,
const char* storeId,
XAsyncBlock* async
)
パラメーター
storeContextHandle _In_
型: XStoreContextHandle
XStoreCreateContext によって返される、ユーザーの Microsoft Store コンテキスト ハンドル。
storeId _In_z_
型: char*
ライセンスを取得する非消費型アイテムの Microsoft Store ID。
async _Inout_
型: XAsyncBlock*
実行されている非同期処理が定義されている XAsyncBlock。 XAsyncBlock を使用して、呼び出しのステータスをポーリングし、呼び出しの結果を取得できます。 詳細については、「XAsyncBlock」を参照してください。
戻り値
型: HRESULT
正常に実行された場合は S_OK を返し、それ以外の場合はエラー コードを返します。
解説
この API は、パッケージなしの非消費型アイテムというアドオンの種類を対象にしています。 パッケージ付き非消費型アイテムの場合は、代わりに XStoreAcquireLicenseForPackageAsync を使用します。
この API により、要求された非消費型アイテムについてライセンスの取得が試行されます。 このデバイスでライセンスを初めて取得した場合は、サービス呼び出しが行われるため、オンライン接続が必要になります。 同じライセンスの後続の呼び出しはキャッシュにより高速になる可能性がありますが、これはいつでも無効にすることができます。 このライセンスへのオフライン アクセスは、オンライン中に一度でもライセンスを取得したことがある場合にのみ行うことができます。 PC の場合は、ライセンスを所有するアカウントにオフライン アクセス許可が設定されている必要があります。
XStoreRegisterPackageLicenseLost を使用して、この API から取得したライセンスが失われたかどうかを監視できます。
要件
ヘッダー: XStore.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体