XStoreRegisterPackageLicenseLost
ライセンス消失イベントのコールバックを登録します。 XStoreAcquireLicenseForPackageAsync および XStoreAcquireLicenseForDurablesAsync を通じて取得した永続ライセンスを登録するには、この API を使用してください。Syntax
Parameters
licenseHandle _In_型: XStoreLicenseHandle コールバックを登録するライセンス ハンドル。 queue _In_
型: XTaskQueueHandle 非同期処理を扱う非同期キュー。 context _In_opt_
型: void* コールバックに渡されるタイトル定義のコンテキスト。 callback _In_
型: XStorePackageLicenseLostCallback* 登録するコールバック。 token _Out_
型: XTaskQueueRegistrationToken* 成功時にはコールバックを識別するためのトークンが格納されます。
Return value
型: HRESULT HRESULT の成功またはエラー コード。Remarks
この関数は、XStorePackageLicenseLostCallback によって定義されたコールバック関数を登録します。 登録されたコールバック関数は、次の永続ライセンス消失イベントが発生したときに呼び出されます。 登録中にコールバック関数が呼び出されることはありません。 ライセンス消失イベントは、購入したアカウントがデバイスからサインアウトし、以前に共有されていたライセンスが現在のユーザーに対して利用できなくなったときによく発生します。 メモリ リークを回避するため、コールバック関数の使用を終えたら XStoreUnregisterPackageLicenseLost を呼び出す必要があります。 永続ライセンスは、ユーザーの変更、ネットワークの変更、同時実行チェック、またはデバイス上でのライセンスの有効期限切れなどにより、いつでも失われる可能性があります。 ゲームはライセンス消失イベントを登録し、コールバックがトリガーされたときに永続ライセンスの再取得を試みる必要があります。 ライセンス消失イベントは、システムが別のアカウントに属するキャッシュされたライセンスを誤って現在のプレイヤーに返した場合の検出にも役立ちます。 このような場合、ライセンス消失イベントが直ちに発生し、XStoreAcquireLicense* を再び呼び出したときに新しいライセンスが提供されます。 使用例については、XStoreAcquireLicenseForPackageAsync を参照してください。Requirements
ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStorePackageLicenseLostCallback
XStoreUnregisterPackageLicenseLost
プレイヤーにアドオン コンテンツへのアクセス許可を付与する