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

Retourne la quantité de données disponibles pour le stockage au moyen de l'API **XGameSave**.

## Syntaxe

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

### Paramètres

*provider*   \_In\_\
Type : XGameSaveProviderHandle

Handle vers le **XGameSaveProvider** pour lequel interroger les données restantes.

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

Quantité de données disponibles pouvant servir de stockage.

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>Cette fonction ne peut pas être appelée sans danger sur un thread sensible au temps. Pour plus d'informations, consultez [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Chaque application dispose d'un quota sur la quantité de données qu'elle peut enregistrer pour un utilisateur; si ce quota est dépassé, toute tentative d'enregistrer davantage de données peut échouer avec **E\_GS\_QUOTA\_EXCEEDED**. Comme il ne s'agit pas d'une taille fixe, nous avons exposé l'accès au quota restant afin que l'application puisse essayer d'éviter les échecs **E\_GS\_QUOTA\_EXCEEDED**. Pour donner une vue exacte, nous nous assurons toujours que les écritures, mises à jour ou suppressions en attente sont traitées avant de retourner, puisque chacune d'elles peut modifier le quota restant. Il est recommandé d'appeler cette fonction pour vous assurer qu'il reste une quantité raisonnable de données pour exécuter un appel à [XGameSaveSubmitUpdate](/fr-CA/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); 
    } 
} 
```

## Configuration requise

**En-tête :** XGameSave.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Systèmes de stockage des sauvegardes de jeu](/fr-CA/build/core-features/common/game-save/game-saves-storage-systems)
* [Vue d'ensemble de l'API XGameSave](/fr-CA/build/core-features/common/game-save/xgamesave)
* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XGameSave](/fr-CA/reference/system/xgamesave/xgamesave_members)\
[XGameSaveSubmitUpdate](/fr-CA/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[Débogage des sauvegardes de jeu](/fr-CA/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)