메인 콘텐츠로 건너뛰기

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년 10월 19일