> ## 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를 사용하세요.

## 구문

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

### 매개 변수

*licenseHandle*   \_In\_\
형식: XStoreLicenseHandle

콜백을 등록할 라이선스 핸들입니다.

*queue*   \_In\_\
형식: XTaskQueueHandle

비동기 작업을 처리할 비동기 큐입니다.

*context*   \_In\_opt\_\
형식: void\*

콜백에 전달할 타이틀 정의 컨텍스트입니다.

*callback*   \_In\_\
형식: XStorePackageLicenseLostCallback\*

등록할 콜백입니다.

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

성공 시 콜백을 식별하는 데 사용되는 토큰을 포함합니다.

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## 설명

이 함수는 [XStorePackageLicenseLostCallback](/reference/system/xstore/functions/xstorepackagelicenselostcallback)에 정의된 콜백 함수를 등록합니다.
등록된 콜백 함수는 다음 지속형 라이선스 손실 이벤트가 발생할 때 호출됩니다.
콜백 함수는 등록 중에는 호출되지 않습니다.
라이선스 손실 이벤트는 구매 계정이 디바이스에서 로그아웃되어 이전에 공유된 라이선스를 현재 사용자가 사용할 수 없게 될 때 자주 발생합니다.
메모리 누수를 방지하려면 콜백 함수 사용을 마쳤을 때 [XStoreUnregisterPackageLicenseLost](/reference/system/xstore/functions/xstoreunregisterpackagelicenselost)를 호출해야 합니다.

지속형 라이선스는 사용자 변경, 네트워크 변경, 동시성 검사, 또는 디바이스에서의 라이선스 만료로 인해 언제든지 손실될 수 있습니다.
게임은 라이선스 손실 이벤트에 등록하고 콜백이 트리거될 때 지속형 항목에 대한 라이선스를 다시 획득하려고 시도해야 합니다.
라이선스 손실 이벤트는 시스템이 다른 계정에 속한 캐시된 라이선스를 현재 플레이어에게 잘못 반환할 때 감지하는 데 도움이 될 수 있습니다.
이러한 경우 라이선스 손실 이벤트가 즉시 발생하고 XStoreAcquireLicense\*가 다시 호출될 때 새로운 라이선스가 제공됩니다.

사용 예시는 [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync)를 참조하세요.

## 요구 사항

**헤더:** XStore.h (XGameRuntime.h에 포함됨)

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 설명서

* [플레이어에게 추가 기능 콘텐츠에 대한 액세스 권한 부여](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-granting-access-to-content)
* [라이선스 테스트 사용](/publishing/xstore-commerce/xstore-licensing-setup)

## 참고 항목

[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](/ko/reference/system/xstore/functions/xstorepackagelicenselostcallback.md)
- [XStoreUnregisterPackageLicenseLost](/ko/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)
- [XStoreAcquireLicenseForPackageResult](/ko/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult.md)
- [XStoreIsLicenseValid](/ko/reference/system/xstore/functions/xstoreislicensevalid.md)
- [XStoreCloseLicenseHandle](/ko/reference/system/xstore/functions/xstorecloselicensehandle.md)