> ## 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.

# XGameSaveGetRemainingQuota

> XGameSaveGetRemainingQuota

# XGameSaveGetRemainingQuota

Retorna a quantidade de dados disponível para armazenamento usando a API **XGameSave**.

## Sintaxe

```cpp theme={null}
HRESULT XGameSaveGetRemainingQuota(  
         XGameSaveProviderHandle provider,  
         int64_t* remainingQuota  
)  
```

### Parâmetros

*provider*   \_In\_\
Tipo: XGameSaveProviderHandle

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

*remainingQuota*   \_Out\_\
Tipo: int64\_t\*

Quantidade de dados disponível para ser usada como armazenamento.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

<Note>Não é seguro chamar esta função em uma thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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. É recomendável chamar esta função para garantir que haja uma quantidade razoável de dados restante para executar uma chamada para [XGameSaveSubmitUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdate).

```cpp theme={null}
void Sample::_GetQuotaSync(uint64_t* remainingQuota) 
{ 
    HRESULT hr = XGameSaveGetRemainingQuota(_provider, remainingQuota); 
    if (FAILED(hr)) 
    { 
        printf("Error retrieving Quota hr=0x%08x\n", hr); 
    } 
} 
```

## 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

* [Sistemas de armazenamento de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-storage-systems)
* [Visão geral da API XGameSave](/pt-BR/build/core-features/common/game-save/xgamesave)
* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

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


## Related topics

- [XGameSaveGetRemainingQuota](/reference/system/xgamesave/functions/xgamesavegetremainingquota.md)
- [Game Saves storage systems](/build/core-features/common/game-save/game-saves-storage-systems.md)
- [XGameSave API overview](/build/core-features/common/game-save/xgamesave.md)
- [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)
- [XGameSave API 개요](/ko/build/core-features/common/game-save/xgamesave.md)