Skip to main content

XStoreQueryLicenseTokenAsync

호출하는 게임에 불투명한 JSON 웹 토큰을 제공하며, 이 토큰을 게임 서비스에 전달하여 사용 권한을 확인하고 B2B 호출을 수행할 수 있습니다. 자세한 내용은 라이선스 토큰 개요를 참조하세요.

구문

매개 변수

storeContextHandle   _In_
형식: XStoreContextHandle
XStoreCreateContext에서 반환된 사용자의 스토어 컨텍스트 핸들입니다. productIds   _In_z_count_(productIdsCount)
형식: char**
토큰을 검색할 제품 ID의 배열입니다. productIdsCount   _In_
형식: size_t
productIds에 전달된 배열에 있는 ID의 수입니다. customDeveloperString   _In_z_
형식: char*
토큰에 왕복 전달되는 값입니다. 일반적으로 서비스에 의해 선택됩니다. userId나 이메일과 같은 값을 삽입하여 라이선스 토큰에서 사용자의 토큰을 추적할 수 있습니다. 라이선스 토큰은 소유권 영수증과 같이 사용됩니다. null이거나 빈 문자열이면 안 됩니다. async   _Inout_
형식: XAsyncBlock*
수행 중인 비동기 작업을 정의하는 XAsyncBlock입니다. XAsyncBlock을 사용하여 호출 상태를 폴링하고 호출 결과를 검색할 수 있습니다. 자세한 내용은 XAsyncBlock을 참조하세요.

반환 값

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

설명

이 함수의 실행 결과와 JSON 웹 토큰을 검색하려면 이 함수를 호출한 후 XStoreQueryLicenseTokenResult를 호출합니다. JSON 웹 토큰의 크기를 검색하려면 이 함수를 호출한 후 XStoreQueryLicenseTokenResultSize를 호출합니다. 토큰의 크기를 알면 더 효율적으로 검색할 수 있습니다. 라이선스 토큰은 Base64로 인코딩된 JSON 웹 토큰입니다. 토큰의 페이로드는 Base64로 인코딩된 문자열이며, 서버에서 유효성 검사에 사용할 수 있는 JSON 값으로 변환됩니다. 다음 코드 조각은 라이선스 토큰을 검색하는 예를 보여줍니다.

요구 사항

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

개념 설명서

참고 항목

XStore 라이선스 토큰 개요 XStoreQueryLicenseTokenResult XStoreQueryLicenseTokenResultSize
마지막 수정일 2026년 8월 28일