> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreRegisterPackageLicenseLost

> XStoreRegisterPackageLicenseLost

# XStoreRegisterPackageLicenseLost

ライセンス消失イベントのコールバックを登録します。
[XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) および [XStoreAcquireLicenseForDurablesAsync](/reference/system/xstore/functions/xstoreacquirelicensefordurablesasync) を通じて取得した永続ライセンスを登録するには、この API を使用してください。

## Syntax

```cpp theme={null}
HRESULT XStoreRegisterPackageLicenseLost(  
         XStoreLicenseHandle licenseHandle,  
         XTaskQueueHandle queue,  
         void* context,  
         XStorePackageLicenseLostCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### Parameters

*licenseHandle*   \_In\_\
型: XStoreLicenseHandle

コールバックを登録するライセンス ハンドル。

*queue*   \_In\_\
型: XTaskQueueHandle

非同期処理を扱う非同期キュー。

*context*   \_In\_opt\_\
型: void\*

コールバックに渡されるタイトル定義のコンテキスト。

*callback*   \_In\_\
型: XStorePackageLicenseLostCallback\*

登録するコールバック。

*token*   \_Out\_\
型: [XTaskQueueRegistrationToken\*](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

成功時にはコールバックを識別するためのトークンが格納されます。

### Return value

型: HRESULT

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

## Remarks

この関数は、[XStorePackageLicenseLostCallback](/reference/system/xstore/functions/xstorepackagelicenselostcallback) によって定義されたコールバック関数を登録します。
登録されたコールバック関数は、次の永続ライセンス消失イベントが発生したときに呼び出されます。
登録中にコールバック関数が呼び出されることはありません。
ライセンス消失イベントは、購入したアカウントがデバイスからサインアウトし、以前に共有されていたライセンスが現在のユーザーに対して利用できなくなったときによく発生します。
メモリ リークを回避するため、コールバック関数の使用を終えたら [XStoreUnregisterPackageLicenseLost](/reference/system/xstore/functions/xstoreunregisterpackagelicenselost) を呼び出す必要があります。

永続ライセンスは、ユーザーの変更、ネットワークの変更、同時実行チェック、またはデバイス上でのライセンスの有効期限切れなどにより、いつでも失われる可能性があります。
ゲームはライセンス消失イベントを登録し、コールバックがトリガーされたときに永続ライセンスの再取得を試みる必要があります。
ライセンス消失イベントは、システムが別のアカウントに属するキャッシュされたライセンスを誤って現在のプレイヤーに返した場合の検出にも役立ちます。
このような場合、ライセンス消失イベントが直ちに発生し、XStoreAcquireLicense\* を再び呼び出したときに新しいライセンスが提供されます。

使用例については、[XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) を参照してください。

## Requirements

**ヘッダー:** XStore.h (XGameRuntime.h に含まれる)

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体および XBOX Series 本体

## Conceptual documentation

* [プレイヤーにアドオン コンテンツへのアクセス許可を付与する](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-granting-access-to-content)
* [ライセンス テストの有効化](/publishing/xstore-commerce/xstore-licensing-setup)

## See also

[XStore](/reference/system/xstore/xstore_members)\
[XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync)\
[XStoreAcquireLicenseForPackageResult](/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult)\
[XStoreIsLicenseValid](/reference/system/xstore/functions/xstoreislicensevalid)\
[XStoreCloseLicenseHandle](/reference/system/xstore/functions/xstorecloselicensehandle)\
[XStorePackageLicenseLostCallback](/reference/system/xstore/functions/xstorepackagelicenselostcallback)\
[XStoreUnregisterPackageLicenseLost](/reference/system/xstore/functions/xstoreunregisterpackagelicenselost)\
[プレイヤーにアドオン コンテンツへのアクセス許可を付与する](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-granting-access-to-content)


## Related topics

- [XStorePackageLicenseLostCallback](/ja-jp/reference/system/xstore/functions/xstorepackagelicenselostcallback.md)
- [XStoreUnregisterPackageLicenseLost](/ja-jp/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)
- [XStoreCloseLicenseHandle](/ja-jp/reference/system/xstore/functions/xstorecloselicensehandle.md)
- [XStoreAcquireLicenseForPackageResult](/ja-jp/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult.md)
- [XStoreIsLicenseValid](/ja-jp/reference/system/xstore/functions/xstoreislicensevalid.md)