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

Devuelve la cantidad de datos disponibles para almacenar mediante la API **XGameSave**.

## Sintaxis

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

### Parámetros

*provider*   \_In\_\
Tipo: XGameSaveProviderHandle

Identificador del **XGameSaveProvider** para el que se consultan los datos restantes.

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

Cantidad de datos disponibles para usar como almacenamiento.

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Cada aplicación tiene una cuota sobre la cantidad de datos que puede guardar para un usuario; si se supera, cualquier intento de guardar más datos puede producir un error **E\_GS\_QUOTA\_EXCEEDED**. Como no se trata de un tamaño fijo, hemos expuesto el acceso a la cuota restante para que la aplicación pueda intentar evitar errores **E\_GS\_QUOTA\_EXCEEDED**. Para ofrecer una vista precisa, siempre nos aseguramos de que las escrituras, actualizaciones o eliminaciones pendientes se procesen primero antes de devolver el resultado, ya que cualquiera de ellas puede cambiar la cuota restante. Se recomienda llamar a esta función para asegurarse de que queda una cantidad razonable de datos para ejecutar una llamada a [XGameSaveSubmitUpdate](/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

**Encabezado:** XGameSave.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Sistemas de almacenamiento de partidas guardadas](/build/core-features/common/game-save/game-saves-storage-systems)
* [Información general de la API XGameSave](/build/core-features/common/game-save/xgamesave)
* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate)\
[Depuración de partidas guardadas](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [Información general de la API XGameSave](/es/build/core-features/common/game-save/xgamesave.md)
- [XGameSave](/es/reference/system/xgamesave/xgamesave_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameSaveGetRemainingQuotaAsync](/es/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md)
- [XGameSaveGetRemainingQuotaResult](/es/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md)