Skip to main content

XStoreQueryProductsAsync

현재 게임과 연결된 지정된 제품에 대한 스토어 목록 정보를 반환합니다. 해당 제품이 게임 내에서 구매 가능한지 여부에 관계없이 반환합니다.

구문

매개 변수

storeContextHandle   _In_
형식: XStoreContextHandle
XStoreCreateContext에서 반환된 사용자의 스토어 컨텍스트 핸들입니다. productKinds   _In_
형식: XStoreProductKind
반환할 제품의 형식입니다. storeIds   _In_z_count_(storeIdsCount)
형식: char**
검색할 제품의 스토어 식별자입니다. storeIdsCount   _In_
형식: size_t
storeIds 목록에 있는 제품의 수입니다. 이 값은 100을 초과할 수 없습니다. actionFilters   _In_opt_z_count_(actionFiltersCount)
형식: char**
제품 문서에 저장된 특정 액션으로 결과를 제한합니다. 기본적으로 이 API는 구매할 수 없는 제품이라도 모든 제품을 반환하지만, 액션 필터를 사용하여 결과를 제한할 수 있습니다. 예를 들어 구매 가능한 제품만 원하는 경우 “Purchase”를 사용하거나 라이선스 가능한 제품만 원하는 경우 “License”를 사용합니다. 다른 액션 필터에는 “Fulfill”, “Browse”, “Curate”, “Details”, “Redeem”이 있습니다. actionFiltersCount   _In_
형식: size_t
actionFilters의 필터 수입니다. async   _Inout_
형식: XAsyncBlock*
수행 중인 비동기 작업을 정의하는 XAsyncBlock입니다. XAsyncBlock을 사용하여 호출 상태를 확인하고 결과를 가져옵니다. 자세한 내용은 XAsyncBlock을 참조하세요.

반환 값

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

설명

이 함수의 실행 결과와 목록 정보를 검색하려면 XStoreQueryProductsResult를 호출합니다. 요청에서 100개를 초과하는 storeID를 제공하면 이 API는 실패합니다. 큰 카탈로그를 다루는 경우 각 쿼리를 100개 미만의 제품으로 제한하세요. 현재 게임 내에서 플레이어가 구매할 수 있는 모든 제품의 세부 정보를 가져오려면 XStoreQueryAssociatedProductsAsync를 대신 사용합니다. 다음 코드 조각은 현재 게임과 연결된 지정된 제품에 대한 목록 정보를 검색하는 예를 보여줍니다.

요구 사항

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

개념 설명서

참고 항목

XStore XStoreQueryProductsResult
XStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
기본 스토어 작업
플레이어에게 추가 기능 콘텐츠에 대한 액세스 권한 부여
마지막 수정일 2026년 8월 24일