Skip to main content

XStoreShowRedeemTokenUIAsync

지정된 토큰에 대해 현재 사용자의 토큰 사용을 트리거합니다.

구문

매개 변수

storeContextHandle   _In_
형식: XStoreContextHandle
XStoreCreateContext에서 반환된 사용자의 스토어 컨텍스트 핸들입니다. token   _In_z_
형식: char*
사용할 토큰입니다. 이 값은 비어 있거나 null일 수 없습니다. UI에 미리 채울 코드를 제공하지 않고 UI를 표시하려면 공백 하나 ” “를 전달합니다. allowedStoreIds   _In_z_count_(allowedStoreIdsCount)
형식: char**
5x5 코드가 특정 제품에만 작동하도록 제한할 수 있습니다. allowedStoreIdsCount   _In_
형식: size_t
allowedStoreIds의 요소 수입니다. disallowCsvRedemption   _In_
형식: bool
CSV(기프트 카드/현금 스타일 5x5)의 사용을 방지합니다. async   _Inout_
형식: XAsyncBlock*
수행 중인 비동기 작업을 정의하는 XAsyncBlock입니다. XAsyncBlock을 사용하여 호출 상태를 폴링하고 호출 결과를 검색할 수 있습니다. 자세한 내용은 XAsyncBlock을 참조하세요.

반환 값

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

설명

이 함수의 실행 결과를 검색하려면 이 함수를 호출한 후 XStoreShowRedeemTokenUIResult를 호출합니다. 다음 코드 조각은 토큰 사용 UI를 시작하는 예를 보여줍니다.

요구 사항

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

참고 항목

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