다음을 통해 공유


XStoreEnumerateProductsQuery

제품 쿼리의 결과를 열거합니다.

구문

HRESULT XStoreEnumerateProductsQuery(  
         const XStoreProductQueryHandle productQueryHandle,  
         void* context,  
         XStoreProductQueryCallback* callback  
)  

매개 변수

productQueryHandle _In_
형식: XStoreProductQueryHandle

결과를 열거할 쿼리의 핸들입니다. XStoreProductQueryHandle은 XStoreQueryProductForCurrentGameResult, XStoreQueryProductForPackageResult.md, XStoreQueryEntitledProductsResult, XStoreQueryAssociatedProductsAsyncXStoreQueryProductsResult에 의해 반환됩니다.

context _In_opt_
형식: void*

콜백에 전달할 게임에서 정의된 컨텍스트입니다.

callback _In_
형식: XStoreProductQueryCallback*

각 제품에 대해 호출할 게임 정의 콜백입니다.

반환 값

형식: HRESULT

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

설명

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전합니다.

이 함수는 제품 정보를 요청하는 함수가 반환하는 제품을 열거하는 데 사용합니다. 제품의 열거를 호출한 후에는 XStoreProductsQueryHasMorePages 함수를 사용하여 추가 제품 정보를 확인합니다. 읽을 제품 정보가 더 있다면 XStoreProductsQueryNextPageAsync를 사용하여 읽습니다. 사용 예는 XStoreQueryAssociatedProductsAsync를 참조하세요.

요구 사항

헤더: XStore.h(XGameRuntime.h에 포함됨)

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XStore
XStoreQueryAssociatedProductsAsync
XStoreQueryProductsResult
XStoreProductQueryCallback