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 以检索列表信息和此函数的执行结果。 如果在请求中提供的 storeID 超过 100 个,此 API 将失败。 如果使用大型目录,请将每个查询限制为少于 100 个产品。 要获取玩家可在当前游戏中购买的所有产品的详细信息,请改用 XStoreQueryAssociatedProductsAsync 以下代码片段展示了检索与当前游戏关联的指定产品的列表信息的示例。

要求

头文件: XStore.h(包含在 XGameRuntime.h 中) 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念文档

另请参阅

XStore XStoreQueryProductsResult
XStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
基本商店操作
授予玩家访问加载项内容的权限
最后修改于 2026年8月24日