Skip to main content

XStoreReportConsumableFulfillmentAsync

Consome a quantidade especificada de um consumível. Para obter mais informações sobre como implementar e usar produtos consumíveis, confira Ecossistemas baseados em consumíveis.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário retornado por XStoreCreateContext. storeProductId   _In_z_
Tipo: char*
A ID da Store do complemento consumível que você deseja relatar como atendido. quantity   _In_
Tipo: uint32_t
O número de unidades do complemento consumível que você deseja relatar como atendidas. Para um consumível gerenciado pela Store (ou seja, um consumível cujo saldo é controlado pela Microsoft), especifique o número de unidades que foram consumidas. Para um consumível gerenciado pelo jogo (ou seja, um consumível cujo saldo é controlado pelo desenvolvedor), especifique 1. trackingId   _In_
Tipo: GUID
Um GUID fornecido pelo desenvolvedor que identifica a transação específica à qual a operação de atendimento está associada, para fins de rastreamento. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Confira XAsyncBlock para obter mais informações.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

Para recuperar o resultado desta função, chame XStoreReportConsumableFulfillmentResult após chamar esta função. O snippet de código a seguir mostra um exemplo de uso de uma quantidade de um consumível.

Requisitos

Cabeçalho: XStore.h (incluído em XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XStore
Ecossistemas baseados em consumíveis XStoreReportConsumableFulfillmentResult
Last modified on October 6, 2026