Skip to main content

XStoreRegisterGameLicenseChanged

타이틀 라이선스 변경 이벤트에 대한 콜백을 등록합니다. 이는 실행 중인 타이틀의 라이선스 변경에만 적용되며, 지속형(DLC) 라이선스에는 적용되지 않습니다.

구문

매개 변수

storeContextHandle   _In_
형식: XStoreContextHandle
XStoreCreateContext에서 반환된 사용자의 스토어 컨텍스트 핸들입니다. queue   _In_
형식: XTaskQueueHandle
비동기 작업을 처리할 비동기 큐입니다. context   _In_opt_
형식: void*
콜백에 전달할 게임 정의 컨텍스트입니다. callback   _In_
형식: XStoreGameLicenseChangedCallback*
등록할 콜백입니다. token   _Out_
형식: XTaskQueueRegistrationToken*
성공 시 콜백을 식별하는 데 사용되는 토큰을 포함합니다.

반환 값

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

설명

이 함수는 XStoreGameLicenseChangedCallback에 정의된 콜백 함수를 등록합니다. 등록된 함수는 다음 게임 라이선스 변경 이벤트가 발생할 때 호출됩니다. 이 이벤트는 현재 게임과 관련된 구매가 이 디바이스에서 발생하거나, 게임의 라이선스가 새로 고쳐지고 게임이 평가판 라이선스에서 전체 라이선스로 이동할 때 발생합니다. 등록된 함수는 등록 자체로는 호출되지 않습니다. 메모리 누수를 방지하려면 콜백 함수 사용을 마쳤을 때 XStoreUnregisterGameLicenseChanged를 호출해야 합니다. 사용 예시는 XStoreCreateContext를 참조하세요.

요구 사항

헤더: XStore.h (XGameRuntime.h에 포함됨) 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 설명서

참고 항목

XStore
XStoreGameLicenseChangedCallback
XStoreUnregisterGameLicenseChanged
마지막 수정일 2026년 8월 24일