Skip to main content

XStoreQueryConsumableBalanceRemainingAsync

获取指定产品 ID 的剩余可消耗余额。

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 返回的用户的应用商店上下文句柄。 storeProductId   _In_z_
类型:char*
要检索余额的可消耗品的 ID。 async   _Inout_
类型:XAsyncBlock*
定义正在执行的异步工作的 XAsyncBlock。可使用 XAsyncBlock 轮询调用状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

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

备注

要检索剩余的可消耗品余额以及此函数的执行结果,请在调用此函数后调用 XStoreQueryConsumableBalanceRemainingResultXStoreQueryConsumableBalanceRemainingResult 应在 XStoreQueryConsumableBalanceRemainingAsync 的回调函数中执行。以下代码片段演示了检索指定产品 ID 的剩余可消耗余额的示例。

要求

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

概念文档

另请参阅

XStore
XStoreQueryConsumableBalanceRemainingResult
XStoreCreateContext
最后修改于 2026年8月24日