XStoreRegisterPackageLicenseLost

라이선스 손실 이벤트에 대한 콜백을 등록합니다. 이는 XStoreAcquireLicenseForPackageAsync를 통해 패키지가 있는 지속성 콘텐츠 및 XStoreAcquireLicenseForDurablesAsync를 통해 얻은 패키지(지속성 콘텐츠 추가 기능이라고도 함)가 없는 지속성 콘텐츠에 대해 얻은 라이선스를 등록하는 데 사용할 수 있습니다.

구문

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*

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

반환 값

형식: HRESULT

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

비고

이 함수는 XStorePackageLicenseLostCallback이 정의하는 콜백 함수를 등록합니다. 등록된 함수는 다음 게임 라이선스 변경 이벤트 발생 시 호출됩니다. 등록된 함수는 등록 작업 발생 시에는 호출되지 않습니다. 일반적으로 이 함수는 사용자가 지정된 패키지에 대한 동시성 제한을 초과하는 경우 발생합니다. 사용자가 추가 로밍 장치에서 패키지를 열 때 주로 발생합니다. 메모리 누수를 방지하려면 콜백 함수 작업이 끝난 후 XStoreUnregisterPackageLicenseLost를 호출해야 합니다.

사용 예는 XStoreAcquireLicenseForPackageAsync를 참조하세요.

요구 사항

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

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XStore
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStorePackageLicenseLostCallback
XStoreUnregisterPackageLicenseLost