Skip to main content

XStoreQueryConsumableBalanceRemainingAsync

Obtém o saldo restante do consumível para a ID de produto especificada.

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 do consumível cujo saldo será recuperado. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo realizado. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Consulte XAsyncBlock para obter mais informações.

Valor retornado

Tipo: HRESULT Código de sucesso ou erro HRESULT.

Comentários

Para recuperar o saldo restante do consumível, bem como o resultado da execução desta função, chame XStoreQueryConsumableBalanceRemainingResult depois de chamar esta função. XStoreQueryConsumableBalanceRemainingResult deve ser executada na função de retorno de chamada de XStoreQueryConsumableBalanceRemainingAsync. O snippet de código a seguir mostra um exemplo de recuperação do saldo restante do consumível para uma ID de produto especificada.

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
XStoreQueryConsumableBalanceRemainingResult
XStoreCreateContext
Last modified on October 6, 2026