Skip to main content

XStoreReportConsumableFulfillmentAsync

Consumes the specified quantity of a consumable. For more information see Consumable-based ecosystems for more information on implementing and using consumable products.

Syntax

Parameters

storeContextHandle   _In_
Type: XStoreContextHandle
The store context handle for the user returned by XStoreCreateContext. storeProductId   _In_z_
Type: char*
The Store ID of the consumable add-on that you want to report as fulfilled. quantity   _In_
Type: uint32_t
The number of units of the consumable add-on that you want to report as fulfilled. For a Store-managed consumable (that is, a consumable where Microsoft keeps track of the balance), specify the number of units that have been consumed. For a game-managed consumable (that is, a consumable where the developer keeps track of the balance), specify 1. trackingId   _In_
Type: GUID
A developer-supplied GUID that identifies the specific transaction that the fulfillment operation is associated with for tracking purposes. async   _Inout_
Type: XAsyncBlock*
An XAsyncBlock defining the asynchronous work being done. The XAsyncBlock can be used to poll for the call’s status and retrieve call results. See XAsyncBlock for more information.

Return value

Type: HRESULT HRESULT success or error code.

Remarks

To retrieve the result of this function call XStoreReportConsumableFulfillmentResult after calling this function. The following code snippet shows an example of using a quantity of a consumable.

Requirements

Header: XStore.h (included in XGameRuntime.h) Library: xgameruntime.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

Conceptual documentation

See also

XStore
Consumable-based ecosystems XStoreReportConsumableFulfillmentResult
Last modified on August 20, 2026