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