> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreEnumerateProductsQuery

> XStoreEnumerateProductsQuery

# XStoreEnumerateProductsQuery

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

## 구문

```cpp theme={null}
HRESULT XStoreEnumerateProductsQuery(  
         const XStoreProductQueryHandle productQueryHandle,  
         void* context,  
         XStoreProductQueryCallback* callback  
)  
```

### 매개 변수

*productQueryHandle*   \_In\_\
형식: XStoreProductQueryHandle

결과를 열거할 쿼리의 핸들입니다. XStoreProductQueryHandle은 [XStoreQueryProductForCurrentGameResult](/reference/system/xstore/functions/xstorequeryproductforcurrentgameresult), [XStoreQueryProductForPackageResult.md](/reference/system/xstore/functions/xstorequeryproductforpackageresult), [XStoreQueryEntitledProductsResult](/reference/system/xstore/functions/xstorequeryentitledproductsresult), [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync) 및 [XStoreQueryProductsResult](/reference/system/xstore/functions/xstorequeryproductsresult)에서 반환됩니다.

*context*   \_In\_opt\_\
형식: void\*

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

*callback*   \_In\_\
형식: [XStoreProductQueryCallback\*](/reference/system/xstore/functions/xstoreproductquerycallback)

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

### 반환 값

형식: HRESULT

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

## 설명

이 함수는 시간에 민감한 스레드에서 안전하게 호출할 수 있습니다.

이 함수는 제품 정보를 요청하는 함수에서 반환된 제품을 열거하는 데 사용됩니다. 필요한 경우 제품 열거를 호출한 후 [XStoreProductsQueryHasMorePages](/reference/system/xstore/functions/xstoreproductsqueryhasmorepages) 함수를 사용하여 추가 제품 정보를 확인합니다. 읽을 제품 정보가 더 있으면 [XStoreProductsQueryNextPageAsync](/reference/system/xstore/functions/xstoreproductsquerynextpageasync)를 사용하여 읽습니다. 사용 예제는 [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync)를 참조하세요.

## 요구 사항

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

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 설명서

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 참고 항목

[XStore](/reference/system/xstore/xstore_members)\
[XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync)\
[XStoreQueryProductsResult](/reference/system/xstore/functions/xstorequeryproductsresult)\
[XStoreProductQueryCallback](/reference/system/xstore/functions/xstoreproductquerycallback)


## Related topics

- [XStoreProductQueryCallback](/ko/reference/system/xstore/functions/xstoreproductquerycallback.md)
- [XStoreProductsQueryHasMorePages](/ko/reference/system/xstore/functions/xstoreproductsqueryhasmorepages.md)
- [XStoreProductsQueryNextPageAsync](/ko/reference/system/xstore/functions/xstoreproductsquerynextpageasync.md)
- [XStoreQueryProductsResult](/ko/reference/system/xstore/functions/xstorequeryproductsresult.md)
- [XStoreQueryAssociatedProductsForStoreIdResult](/ko/reference/system/xstore/functions/xstorequeryassociatedproductsforstoreidresult.md)