> ## 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.

# XStoreQueryEntitledProductsResult

> XStoreQueryEntitledProductsResult

# XStoreQueryEntitledProductsResult

获取对 [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryentitledproductsasync.md) 调用的结果。

## 语法

```cpp theme={null}
HRESULT XStoreQueryEntitledProductsResult(  
         XAsyncBlock* async,  
         XStoreProductQueryHandle* productQueryHandle  
)  
```

### 参数

*async*   \_Inout\_\
类型：[XAsyncBlock\*](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md)

传递给 [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryentitledproductsasync.md) 的 `XAsyncBlock`。
使用 [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md) 轮询调用状态并检索调用结果。
有关详细信息，请参阅 [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md)。

*productQueryHandle*   \_Out\_\
类型：XStoreProductQueryHandle\*

返回时，包含表示查询的 XStoreProductQueryHandle。可将返回的 XStoreProductQueryHandle 传递给 [XStoreEnumerateProductsQuery](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreenumerateproductsquery.md) 以枚举查询返回的产品。

### 返回值

类型：HRESULT

成功时返回 S\_OK；否则返回错误代码。

## 备注

此结果函数检索 [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryentitledproductsasync.md) 的执行结果，如果执行成功，还会检索产品信息。
通常在回调函数的上下文中，于 [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryentitledproductsasync.md) 之后调用此函数。

有关用法示例，请参阅 [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryentitledproductsasync.md)。

## 要求

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

**库：** xgameruntime.lib

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

## 概念文档

* [向玩家授予附加内容的访问权限](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-granting-access.md)
* [在游戏中实现游戏内购买](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-services/e2e-in-game-purchases)
* [基本应用商店操作](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-basic-operations.md)

## 另请参阅

[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)\
[XStoreQueryEntitledProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryentitledproductsasync.md)\
[XStoreQueryProductsAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductsasync.md)\
[XStoreQueryProductForCurrentGameAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductforcurrentgameasync.md)\
[XStoreQueryProductForPackageAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorequeryproductforpackageasync.md)\
[基本应用商店操作](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-basic-operations.md)\
[向玩家授予附加内容的访问权限](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-granting-access.md)


## Related topics

- [XStoreCloseProductsQueryHandle](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstorecloseproductsqueryhandle.md)
- [XStoreEnumerateProductsQuery](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreenumerateproductsquery.md)
- [XStoreProductsQueryHasMorePages](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductsqueryhasmorepages.md)
- [商店基本操作](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-basic-operations.md)
- [XStoreProductsQueryNextPageAsync](https://docs.xbox.com/zh-CN/reference/system/xstore/functions/xstoreproductsquerynextpageasync.md)