Skip to main content

XStoreQueryConsumableBalanceRemainingAsync

取得指定產品識別碼的消耗性剩餘餘額。

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
由 XStoreCreateContext 傳回之使用者的商店內容控制代碼。 storeProductId   _In_z_
類型:char*
要擷取其餘額之消耗性產品的識別碼。 async   _Inout_
類型:XAsyncBlock*
定義正在進行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

若要擷取剩餘的消耗性餘額以及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreQueryConsumableBalanceRemainingResult。XStoreQueryConsumableBalanceRemainingResult 應在 XStoreQueryConsumableBalanceRemainingAsync 的回呼函式中執行。下列程式碼片段示範如何擷取指定產品識別碼的消耗性剩餘餘額。

需求

標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XStore
XStoreQueryConsumableBalanceRemainingResult
XStoreCreateContext
Last modified on October 6, 2026