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

# XGameSave (contenido de la API)

> XGameSave

# XGameSave

La API XGameSave está diseñada para permitir crear, cargar, guardar y administrar estados relacionados con el juego. La principal diferencia entre esta y las implementaciones anteriores es que esta proporciona una API plana con acceso a un modelo de programación asincrónica que permite al autor de la llamada controlar los subprocesos y la administración de memoria del comportamiento de la API.

## Funciones

| Función | Descripción |
| - | - |
| [XGameSaveBlobInfoCallback](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveblobinfocallback.md) | Función de devolución de llamada para recuperar los resultados de [XGameSaveEnumerateBlobInfo](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md). |
| [XGameSaveCloseContainer](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveclosecontainer.md) | Cierra el XGameSaveContainer. |
| [XGameSaveCloseProvider](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavecloseprovider.md) | Libera los recursos retenidos por el XGameSaveProvider. |
| [XGameSaveCloseUpdate](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavecloseupdate.md) | Cierra un XGameSaveUpdate. |
| [XGameSaveContainerInfoCallback](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md) | La función de devolución de llamada para una llamada realizada a [XGameSaveGetContainerInfo](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md). |
| [XGameSaveCreateContainer](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavecreatecontainer.md) | Crea un identificador de XGameSaveContainer. |
| [XGameSaveCreateUpdate](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavecreateupdate.md) | Crea una actualización que se enviará más adelante llamando a [XGameSaveSubmitUpdate](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavesubmitupdate.md). |
| [XGameSaveDeleteContainer](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavedeletecontainer.md) | Elimina un XGameSaveContainer del almacenamiento en la nube. |
| [XGameSaveDeleteContainerAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md) | Elimina un XGameSaveContainer de forma asincrónica. |
| [XGameSaveDeleteContainerResult](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavedeletecontainerresult.md) | Recupera el resultado de una llamada a [XGameSaveDeleteContainerAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md); use esta función para comprobar el éxito de la llamada. |
| [XGameSaveEnumerateBlobInfo](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md) | Recupera la información de blob del contenido de un XGameSaveContainer. |
| [XGameSaveEnumerateBlobInfoByName](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname.md) | Recupera la información de blob del contenido de un XGameSaveContainer limitada a los blobs que comparten un prefijo con el parámetro blobNamePrefix. |
| [XGameSaveEnumerateContainerInfo](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md) | Recupera la información de contenedor de un XGameSaveProvider. |
| [XGameSaveEnumerateContainerInfoByName](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname.md) | Recupera la información de contenedor de un XGameSaveProvider. |
| [XGameSaveGetContainerInfo](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md) | Recupera información de los contenedores de un XGameSaveProvider. |
| [XGameSaveGetRemainingQuota](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavegetremainingquota.md) | Devuelve la cantidad de datos disponibles para almacenar mediante la API XGameSave. |
| [XGameSaveGetRemainingQuotaAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md) | Devuelve de forma asincrónica la cantidad de datos disponibles para almacenar mediante la API XGameSave. |
| [XGameSaveGetRemainingQuotaResult](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md) | Recupera los resultados de la función [XGameSaveGetRemainingQuotaAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md). |
| [XGameSaveInitializeProvider](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveinitializeprovider.md) | Proporciona e inicializa un identificador de proveedor de XGameSave. |
| [XGameSaveInitializeProviderAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md) | Proporciona e inicializa de forma asincrónica un identificador de proveedor de XGameSave. |
| [XGameSaveInitializeProviderResult](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult.md) | Contiene los resultados de una llamada a [XGameSaveInitializeProviderAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md). |
| [XGameSaveReadBlobData](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavereadblobdata.md) | Lee los datos de blob de un contenedor. |
| [XGameSaveReadBlobDataAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md) | Lee de forma asincrónica los datos de XGameSaveBlob de un XGameSaveContainer. |
| [XGameSaveReadBlobDataResult](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavereadblobdataresult.md) | Recupera los resultados de una llamada a [XGameSaveReadBlobDataAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md). |
| [XGameSaveSubmitBlobDelete](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavesubmitblobdelete.md) | Agrega una acción de eliminación a un XGameSaveUpdate de partida guardada. |
| [XGameSaveSubmitBlobWrite](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavesubmitblobwrite.md) | Agrega una acción de escritura a un XGameSaveUpdate. |
| [XGameSaveSubmitUpdate](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavesubmitupdate.md) | Envía una actualización al servicio XGameSave. Actualiza los blobs de un contenedor. |
| [XGameSaveSubmitUpdateAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md) | Envía de forma asincrónica una actualización al servicio XGameSave. Actualiza los blobs de un contenedor. |
| [XGameSaveSubmitUpdateResult](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavesubmitupdateresult.md) | Recupera el resultado de la llamada a [XGameSaveSubmitUpdateAsync](https://docs.xbox.com/es/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md). |

## Estructuras

| Estructura | Descripción |
| - | - |
| [XGameSaveBlob](https://docs.xbox.com/es/reference/system/xgamesave/structs/xgamesaveblob.md) | Unidad de información para el almacenamiento de XGameSave. Reside dentro de un XGameSaveContainer. |
| [XGameSaveBlobInfo](https://docs.xbox.com/es/reference/system/xgamesave/structs/xgamesaveblobinfo.md) | Información sobre el XGameSaveBlob. |
| [XGameSaveContainerInfo](https://docs.xbox.com/es/reference/system/xgamesave/structs/xgamesavecontainerinfo.md) | Información sobre un XGameSaveContainer. |

## Códigos de error

Las API de XGameSave pueden devolver los siguientes códigos de error. Para obtener una lista completa, consulte [Códigos de error](https://docs.xbox.com/es/reference/errorcodes.md). Para obtener instrucciones detalladas de solución de problemas, consulte [Depuración de partidas guardadas](https://docs.xbox.com/es/build/core-features/common/game-save/game-saves-debugging.md).

| Código | Valor | Descripción |
| - | - | - |
| E\_GS\_INVALID\_CONTAINER\_NAME | 0x80830001 | El nombre del contenedor no es válido. Los caracteres válidos para el nombre de un contenedor incluyen letras mayúsculas y minúsculas, dígitos, guiones bajos y barras diagonales. |
| E\_GS\_NO\_ACCESS | 0x80830002 | Error en la operación porque el título no tiene acceso a los espacios de almacenamiento de contenedores. Compruebe que el SCID y el TitleId están configurados correctamente. |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE | 0x80830003 | El dispositivo no tiene suficiente capacidad de almacenamiento para guardar la partida. |
| E\_GS\_USER\_CANCELED | 0x80830004 | El usuario canceló la descarga de sus partidas guardadas. |
| E\_GS\_UPDATE\_TOO\_BIG | 0x80830005 | El tamaño de la actualización de guardado es demasiado grande. El tamaño total de una actualización de XGameSave debe ser menor que GS\_MAX\_BLOB\_SIZE (16 MB). |
| E\_GS\_QUOTA\_EXCEEDED | 0x80830006 | Se superó la cuota de almacenamiento del título para este usuario. |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL | 0x80830007 | El búfer proporcionado a la API era demasiado pequeño. |
| E\_GS\_BLOB\_NOT\_FOUND | 0x80830008 | No se encuentra el blob especificado. |
| E\_GS\_NO\_SERVICE\_CONFIGURATION | 0x80830009 | El título no está configurado correctamente para el almacenamiento conectado. Compruebe que el SCID es correcto y que el título está configurado en Partner Center. |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC | 0x8083000A | El contenedor aún no está sincronizado. Asegúrese de que el contenedor de XGameSave esté sincronizado antes de enviar actualizaciones. |
| E\_GS\_CONTAINER\_SYNC\_FAILED | 0x8083000B | Error en la sincronización del contenedor. |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | La MSA del usuario aún no es una cuenta de servicios de XBOX. |
| E\_GS\_HANDLE\_EXPIRED | 0x8083000D | El identificador que usa la función expiró y debe volver a adquirirse. |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED | 0x8083000E | Se está llamando a esta función sincrónica en un subproceso sensible al tiempo y se corre el riesgo de interbloqueos. Use la implementación asincrónica en su lugar. |
| E\_GS\_PROVIDER\_MISMATCH | 0x8083000F | El juego está combinando llamadas a XGameSave y XGameSaveFiles, lo que no se admite. |

## Documentación conceptual

* [Información general sobre partidas guardadas](https://docs.xbox.com/es/build/core-features/common/game-save/game-saves-overview.md)
* [Guía de XGameSave](https://docs.xbox.com/es/build/core-features/common/game-save/xgamesave.md)
* [Depuración de partidas guardadas](https://docs.xbox.com/es/build/core-features/common/game-save/game-saves-debugging.md)

## Consulte también

[Referencia de API del sistema](https://docs.xbox.com/es/reference/system/gc-reference-system-toc.md)


## Related topics

- [Referencia del contenedor XGameSave (contenido de la API)](https://docs.xbox.com/es/reference/system/Wrappers/xgamesave_wrapper_members.md)
- [Información general de la API XGameSave](https://docs.xbox.com/es/build/core-features/common/game-save/xgamesave.md)
- [Depuración de Game Saves](https://docs.xbox.com/es/build/core-features/common/game-save/game-saves-debugging.md)
- [Herramientas de Game Saves](https://docs.xbox.com/es/build/core-features/common/game-save/game-saves-tools.md)
- [Sistemas de almacenamiento de Game Saves](https://docs.xbox.com/es/build/core-features/common/game-save/game-saves-storage-systems.md)