XStoreRegisterPackageLicenseLost
라이선스 손실 이벤트에 대한 콜백을 등록합니다. XStoreAcquireLicenseForPackageAsync 및 XStoreAcquireLicenseForDurablesAsync를 통해 획득한 지속형 라이선스를 등록하려면 이 API를 사용하세요.구문
매개 변수
licenseHandle _In_형식: XStoreLicenseHandle 콜백을 등록할 라이선스 핸들입니다. queue _In_
형식: XTaskQueueHandle 비동기 작업을 처리할 비동기 큐입니다. context _In_opt_
형식: void* 콜백에 전달할 타이틀 정의 컨텍스트입니다. callback _In_
형식: XStorePackageLicenseLostCallback* 등록할 콜백입니다. token _Out_
형식: XTaskQueueRegistrationToken* 성공 시 콜백을 식별하는 데 사용되는 토큰을 포함합니다.
반환 값
형식: HRESULT HRESULT 성공 또는 오류 코드입니다.설명
이 함수는 XStorePackageLicenseLostCallback에 정의된 콜백 함수를 등록합니다. 등록된 콜백 함수는 다음 지속형 라이선스 손실 이벤트가 발생할 때 호출됩니다. 콜백 함수는 등록 중에는 호출되지 않습니다. 라이선스 손실 이벤트는 구매 계정이 디바이스에서 로그아웃되어 이전에 공유된 라이선스를 현재 사용자가 사용할 수 없게 될 때 자주 발생합니다. 메모리 누수를 방지하려면 콜백 함수 사용을 마쳤을 때 XStoreUnregisterPackageLicenseLost를 호출해야 합니다. 지속형 라이선스는 사용자 변경, 네트워크 변경, 동시성 검사, 또는 디바이스에서의 라이선스 만료로 인해 언제든지 손실될 수 있습니다. 게임은 라이선스 손실 이벤트에 등록하고 콜백이 트리거될 때 지속형 항목에 대한 라이선스를 다시 획득하려고 시도해야 합니다. 라이선스 손실 이벤트는 시스템이 다른 계정에 속한 캐시된 라이선스를 현재 플레이어에게 잘못 반환할 때 감지하는 데 도움이 될 수 있습니다. 이러한 경우 라이선스 손실 이벤트가 즉시 발생하고 XStoreAcquireLicense*가 다시 호출될 때 새로운 라이선스가 제공됩니다. 사용 예시는 XStoreAcquireLicenseForPackageAsync를 참조하세요.요구 사항
헤더: XStore.h (XGameRuntime.h에 포함됨) 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔개념 설명서
참고 항목
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStorePackageLicenseLostCallback
XStoreUnregisterPackageLicenseLost
플레이어에게 추가 기능 콘텐츠에 대한 액세스 권한 부여