XStoreReportConsumableFulfillmentAsync
消耗指定數量的消費性產品。如需實作和使用消費性產品的詳細資訊,請參閱以消費性產品為基礎的生態系統。語法
參數
storeContextHandle _In_類型:XStoreContextHandle 由 XStoreCreateContext 傳回的使用者市集內容控制代碼。 storeProductId _In_z_
類型:char* 您要回報為已履行之消費性附加元件的市集識別碼。 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
