Skip to main content

XStoreShowGiftingUIAsync

지정된 제품을 다른 사용자에게 선물로 구매하기 위한 UI 오버레이를 시작합니다. 현재 사용자에게 선물 수신자에 대한 정보를 입력하라는 메시지가 표시되고 구매 흐름을 안내합니다.

구문

매개 변수

storeContextHandle   _In_
형식: XStoreContextHandle
XStoreCreateContext에서 반환된 사용자의 스토어 컨텍스트 핸들입니다. storeId   _In_z_
형식: char*
선물로 구매할 제품의 ID입니다. 참고: 이 제품은 선물 구매를 지원하도록 구성되어 있어야 합니다. name   _In_opt_z_
형식: char*
선물로 구매할 제품의 이름입니다. extendedJsonData   _In_opt_z_
형식: char*
선물 구매 흐름에 전달되는 JSON blob입니다. 사용자 지정 캠페인 ID를 삽입할 수 있으므로 구매가 어떻게 시작되었는지 추적할 수 있습니다. async   _Inout_
형식: XAsyncBlock*
수행 중인 비동기 작업을 정의하는 XAsyncBlock입니다. XAsyncBlock을 사용하여 호출 상태를 폴링하고 호출 결과를 검색할 수 있습니다. 자세한 내용은 XAsyncBlock을 참조하세요.

반환 값

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

설명

선물로 구매할 제품은 선물 구매를 지원하도록 구성되어야 합니다. 선물을 지원하는 제품 목록을 검색하려면 actionFilters 매개 변수를 "Gift"로 설정하여 XStoreQueryProductsAsync를 호출합니다. 이 함수의 결과를 검색하려면 이 함수를 호출한 후 XStoreShowGiftingUIResult를 호출합니다. 이 함수는 사용자가 무언가를 선물로 구매하기로 선택한 경우에만 호출해야 하며, 결제 정보 및 사용자 확인을 프로세스 외부에서 처리하는 모달 구매 대화 상자를 시스템이 표시하도록 합니다. 다음 코드 조각은 특정 스토어 제품에 대해 선물 구매를 요청하는 예를 보여줍니다.

요구 사항

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

참고 항목

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