XStoreReportConsumableFulfillmentAsync
消耗指定数量的消耗品。有关实现和使用消耗品产品的详细信息,请参阅基于消耗品的生态系统。语法
参数
storeContextHandle _In_类型:XStoreContextHandle XStoreCreateContext 为用户返回的商店上下文句柄。 storeProductId _In_z_
类型:char* 要报告为已履行的消耗品加载项的商店 ID。 quantity _In_
类型:uint32_t 要报告为已履行的消耗品加载项的单位数量。对于商店托管的消耗品(即由 Microsoft 跟踪余额的消耗品),请指定已消耗的单位数量。对于游戏托管的消耗品(即由开发人员跟踪余额的消耗品),请指定 1。 trackingId _In_
类型:GUID 由开发人员提供的 GUID,用于标识与履行操作关联的特定事务,以便进行跟踪。 async _Inout_
类型:XAsyncBlock* 定义正在完成的异步工作的 XAsyncBlock。XAsyncBlock 可用于轮询调用的状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock。
返回值
类型:HRESULT HRESULT 成功或错误代码。备注
要检索此函数调用的结果,请在调用此函数之后调用 XStoreReportConsumableFulfillmentResult。 以下代码片段展示了使用一定数量的消耗品的示例。要求
头文件: XStore.h(包含在 XGameRuntime.h 中) 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
XStore基于消耗品的生态系统 XStoreReportConsumableFulfillmentResult
