Skip to main content

XStoreReportConsumableFulfillmentAsync

消耗指定数量的消耗品。有关实现和使用消耗品产品的详细信息,请参阅基于消耗品的生态系统

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 为用户返回的商店上下文句柄。 storeProductId   _In_z_
类型:char*
要报告为已履行的消耗品加载项的商店 ID。 quantity   _In_
类型:uint32_t
要报告为已履行的消耗品加载项的单位数量。对于商店托管的消耗品(即由 Microsoft 跟踪余额的消耗品),请指定已消耗的单位数量。对于游戏托管的消耗品(即由开发人员跟踪余额的消耗品),请指定 1。 trackingId   _In_
类型:GUID
由开发人员提供的 GUID,用于标识与履行操作关联的特定事务,以便进行跟踪。 async   _Inout_
类型:XAsyncBlock*
定义正在完成的异步工作的 XAsyncBlockXAsyncBlock 可用于轮询调用的状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

类型:HRESULT HRESULT 成功或错误代码。

备注

要检索此函数调用的结果,请在调用此函数之后调用 XStoreReportConsumableFulfillmentResult 以下代码片段展示了使用一定数量的消耗品的示例。

要求

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

概念文档

另请参阅

XStore
基于消耗品的生态系统 XStoreReportConsumableFulfillmentResult
最后修改于 2026年8月24日