> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSaveGetRemainingQuotaAsync

> XGameSaveGetRemainingQuotaAsync

# XGameSaveGetRemainingQuotaAsync

Retorna de forma assíncrona a quantidade de dados disponível para armazenamento usando a API XGameSave.

## Sintaxe

```cpp theme={null}
HRESULT XGameSaveGetRemainingQuotaAsync(  
         XGameSaveProviderHandle provider,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*provider*   \_In\_\
Tipo: XGameSaveProviderHandle

Identificador para o XGameSaveProvider cujos dados restantes serão consultados.

*async*   \_In\_\
Tipo: [XAsyncBlock\*](/pt-BR/reference/system/xasync/structs/xasyncblock)

AsyncBlock que contém o contexto de chamada e a função de retorno de chamada.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

O resultado e a cota restante são recuperados da função [XGameSaveGetRemainingQuotaResult](/pt-BR/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult).

Cada aplicativo tem uma cota de quantos dados pode salvar para um usuário; se ela for excedida, qualquer tentativa de salvar mais dados poderá falhar com **E\_GS\_QUOTA\_EXCEEDED**. Como esse não é um tamanho fixo, expusemos o acesso à cota restante para que o aplicativo possa tentar evitar falhas **E\_GS\_QUOTA\_EXCEEDED**. Para fornecer uma visão precisa, sempre garantimos que quaisquer gravações, atualizações ou exclusões pendentes sejam tratadas primeiro antes de retornar, pois qualquer uma delas pode alterar a cota restante.

## Requisitos

**Cabeçalho:** XGameSave.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Modelo de programação assíncrona](/pt-BR/build/core-features/common/async/async-programming-model)

## Confira também

[XGameSave](/pt-BR/reference/system/xgamesave/xgamesave_members)\
[XGameSaveGetRemainingQuotaResult](/pt-BR/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult)\
[Depuração de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveGetRemainingQuotaAsync](/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md)
- [XGameSaveGetRemainingQuotaResult](/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md)