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 XStoreQueryProductsResultXStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
基本商店操作
授予玩家访问加载项内容的权限
