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

# XGameSave

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

## Estructuras

| Estructura                                                                           | Descripción                                                                                        |
| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| [XGameSaveBlob](/reference/system/xgamesave/structs/xgamesaveblob)                   | Unidad de información para el almacenamiento de XGameSave. Reside dentro de un XGameSaveContainer. |
| [XGameSaveBlobInfo](/reference/system/xgamesave/structs/xgamesaveblobinfo)           | Información sobre el XGameSaveBlob.                                                                |
| [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo) | 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](/reference/errorcodes). Para obtener instrucciones detalladas de solución de problemas, consulte [Depuración de partidas guardadas](/build/core-features/common/game-save/game-saves-debugging).

| 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](/build/core-features/common/game-save/game-saves-overview)
* [Guía de XGameSave](/build/core-features/common/game-save/xgamesave)
* [Depuración de partidas guardadas](/build/core-features/common/game-save/game-saves-debugging)

## Consulte también

[Referencia de API del sistema](/reference/system/gc-reference-system-toc)


## Related topics

- [Referencia del método Save de XGameSave Provider](/es/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSaveBlob](/es/reference/system/xgamesave/structs/xgamesaveblob.md)
- [XGameSaveFiles](/es/reference/system/xgamesavefiles/xgamesavefiles_members.md)
- [Información general de la API XGameSave](/es/build/core-features/common/game-save/xgamesave.md)
- [XGameSaveCreateUpdate](/es/reference/system/xgamesave/functions/xgamesavecreateupdate.md)
