> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductforcurrentgameresult.md)、[XStoreQueryProductForPackageResult.md](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductforpackageresult.md)、[XStoreQueryEntitledProductsResult](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryentitledproductsresult.md)、[XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md) 和 [XStoreQueryProductsResult](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductsresult.md) 返回。

*context*   \_In\_opt\_\
类型：void\*

要传递给回调的、由游戏定义的上下文。

*callback*   \_In\_\
类型：[XStoreProductQueryCallback\*](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductquerycallback.md)

将为每个产品调用的、由游戏定义的回调。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

此函数可在时间敏感线程上安全调用。

此函数用于枚举请求产品信息的函数所返回的产品。如有必要，一旦你调用了产品枚举，可使用 [XStoreProductsQueryHasMorePages](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductsqueryhasmorepages.md) 函数来检查是否有更多产品信息。如果有更多产品信息要读取，则使用 [XStoreProductsQueryNextPageAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductsquerynextpageasync.md) 来读取。有关用法示例，请参阅 [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md)。

## 要求

**头文件：** XStore.h（包含于 XGameRuntime.h 中）

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 概念文档

* [时间敏感线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另请参阅

[XStore](https://docs.xbox.com/zh-CN/reference/system/xstore/xstore_members.md)\
[XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md)\
[XStoreQueryProductsResult](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductsresult.md)\
[XStoreProductQueryCallback](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductquerycallback.md)


## Related topics

- [XStoreProductQueryCallback](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductquerycallback.md)
- [XStoreProductsQueryHasMorePages](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductsqueryhasmorepages.md)
- [XStoreProductsQueryNextPageAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductsquerynextpageasync.md)
- [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md)
- [XStoreQueryProductsResult](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductsresult.md)
