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

Renvoie la quantité de données disponible pour le stockage à l'aide 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 l'espace de données restant.

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

Quantité de données disponible pour le stockage.

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d'informations, consultez [Threads à durée critique](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'enregistrement de données supplémentaires peut échouer avec **E\_GS\_QUOTA\_EXCEEDED**. Comme il ne s'agit pas d'une taille fixe, nous exposons l'accès au quota restant afin que l'application puisse essayer d'éviter les échecs **E\_GS\_QUOTA\_EXCEEDED**. Pour fournir une vue précise, nous nous assurons toujours que les écritures, mises à jour ou suppressions en attente sont traitées avant le retour, car chacune d'elles peut modifier le quota restant. Il est recommandé d'appeler cette fonction pour vérifier qu'il reste une quantité de données raisonnable avant d'exécuter un appel à [XGameSaveSubmitUpdate](/fr/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 de Game Saves](/fr/build/core-features/common/game-save/game-saves-storage-systems)
* [Vue d'ensemble de l'API XGameSave](/fr/build/core-features/common/game-save/xgamesave)
* [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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