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

A API XGameSave foi projetada para permitir criar, carregar, salvar e gerenciar estados relacionados ao jogo. A principal diferença entre esta e as implementações anteriores é que esta fornecerá uma API simples com acesso a um Modelo de Programação Assíncrona que permite ao chamador controlar o threading e o gerenciamento de memória do comportamento da API.

## Funções

| Função | Descrição |
| - | - |
| [XGameSaveBlobInfoCallback](/pt-BR/reference/system/xgamesave/functions/xgamesaveblobinfocallback) | Função de retorno de chamada para recuperar os resultados de [XGameSaveEnumerateBlobInfo](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo). |
| [XGameSaveCloseContainer](/pt-BR/reference/system/xgamesave/functions/xgamesaveclosecontainer) | Fecha o XGameSaveContainer. |
| [XGameSaveCloseProvider](/pt-BR/reference/system/xgamesave/functions/xgamesavecloseprovider) | Libera os recursos mantidos pelo XGameSaveProvider. |
| [XGameSaveCloseUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavecloseupdate) | Fecha um XGameSaveUpdate. |
| [XGameSaveContainerInfoCallback](/pt-BR/reference/system/xgamesave/functions/xgamesavecontainerinfocallback) | A função de retorno de chamada para uma chamada feita a [XGameSaveGetContainerInfo](/pt-BR/reference/system/xgamesave/functions/xgamesavegetcontainerinfo). |
| [XGameSaveCreateContainer](/pt-BR/reference/system/xgamesave/functions/xgamesavecreatecontainer) | Cria um identificador de XGameSaveContainer. |
| [XGameSaveCreateUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavecreateupdate) | Cria uma atualização que será enviada posteriormente chamando [XGameSaveSubmitUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdate). |
| [XGameSaveDeleteContainer](/pt-BR/reference/system/xgamesave/functions/xgamesavedeletecontainer) | Exclui um XGameSaveContainer do armazenamento em nuvem. |
| [XGameSaveDeleteContainerAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) | Exclui um XGameSaveContainer de forma assíncrona. |
| [XGameSaveDeleteContainerResult](/pt-BR/reference/system/xgamesave/functions/xgamesavedeletecontainerresult) | Recupera o resultado de uma chamada de [XGameSaveDeleteContainerAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavedeletecontainerasync); use esta função para verificar o êxito da chamada. |
| [XGameSaveEnumerateBlobInfo](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) | Recupera as informações de blob do conteúdo de um XGameSaveContainer. |
| [XGameSaveEnumerateBlobInfoByName](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname) | Recupera as informações de blob do conteúdo de um XGameSaveContainer, limitadas aos blobs que compartilham um prefixo com o parâmetro blobNamePrefix. |
| [XGameSaveEnumerateContainerInfo](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) | Recupera as informações de contêiner de um XGameSaveProvider. |
| [XGameSaveEnumerateContainerInfoByName](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) | Recupera as informações de contêiner de um XGameSaveProvider. |
| [XGameSaveGetContainerInfo](/pt-BR/reference/system/xgamesave/functions/xgamesavegetcontainerinfo) | Recupera informações dos contêineres em um XGameSaveProvider. |
| [XGameSaveGetRemainingQuota](/pt-BR/reference/system/xgamesave/functions/xgamesavegetremainingquota) | Retorna a quantidade de dados disponível para armazenamento usando a API XGameSave. |
| [XGameSaveGetRemainingQuotaAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync) | Retorna, de forma assíncrona, a quantidade de dados disponível para armazenamento usando a API XGameSave. |
| [XGameSaveGetRemainingQuotaResult](/pt-BR/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult) | Recupera os resultados da função [XGameSaveGetRemainingQuotaAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync). |
| [XGameSaveInitializeProvider](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeprovider) | Fornece e inicializa um identificador de XGameSave Provider. |
| [XGameSaveInitializeProviderAsync](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) | Fornece e inicializa um identificador de XGameSave Provider de forma assíncrona. |
| [XGameSaveInitializeProviderResult](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult) | Contém os resultados de uma chamada de [XGameSaveInitializeProviderAsync](/pt-BR/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync). |
| [XGameSaveReadBlobData](/pt-BR/reference/system/xgamesave/functions/xgamesavereadblobdata) | Lê os dados de blob de um contêiner. |
| [XGameSaveReadBlobDataAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavereadblobdataasync) | Lê dados de XGameSaveBlob de um XGameSaveContainer de forma assíncrona. |
| [XGameSaveReadBlobDataResult](/pt-BR/reference/system/xgamesave/functions/xgamesavereadblobdataresult) | Recupera os resultados de uma chamada de [XGameSaveReadBlobDataAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavereadblobdataasync). |
| [XGameSaveSubmitBlobDelete](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitblobdelete) | Adiciona uma ação de exclusão a um XGameSaveUpdate de salvamento de jogo. |
| [XGameSaveSubmitBlobWrite](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) | Adiciona uma ação de gravação a um XGameSaveUpdate. |
| [XGameSaveSubmitUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdate) | Envia uma atualização para o serviço XGameSave. Atualiza blobs dentro de um contêiner. |
| [XGameSaveSubmitUpdateAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) | Envia uma atualização para o serviço XGameSave de forma assíncrona. Atualiza blobs dentro de um contêiner. |
| [XGameSaveSubmitUpdateResult](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdateresult) | Recupera o resultado da chamada de [XGameSaveSubmitUpdateAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdateasync). |

## Estruturas

| Estrutura | Descrição |
| - | - |
| [XGameSaveBlob](/pt-BR/reference/system/xgamesave/structs/xgamesaveblob) | Unidade de informação para o armazenamento do XGameSave. Reside dentro de um XGameSaveContainer. |
| [XGameSaveBlobInfo](/pt-BR/reference/system/xgamesave/structs/xgamesaveblobinfo) | Informações sobre o XGameSaveBlob. |
| [XGameSaveContainerInfo](/pt-BR/reference/system/xgamesave/structs/xgamesavecontainerinfo) | Informações sobre um XGameSaveContainer. |

## Códigos de erro

Os códigos de erro a seguir podem ser retornados pelas APIs XGameSave. Para obter uma lista completa, consulte [Códigos de erro](/pt-BR/reference/errorcodes). Para obter diretrizes detalhadas de solução de problemas, consulte [Depuração de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-debugging).

| Código | Valor | Descrição |
| - | - | - |
| E\_GS\_INVALID\_CONTAINER\_NAME | 0x80830001 | O nome do contêiner é inválido. Os caracteres válidos para nomes de contêiner incluem letras maiúsculas/minúsculas, dígitos, sublinhados e barras. |
| E\_GS\_NO\_ACCESS | 0x80830002 | A operação falhou porque o título não tem acesso aos espaços de armazenamento do contêiner. Verifique se o SCID e o TitleId estão configurados corretamente. |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE | 0x80830003 | O dispositivo não tem capacidade de armazenamento suficiente para salvar o jogo. |
| E\_GS\_USER\_CANCELED | 0x80830004 | O usuário cancelou o download de seus jogos salvos. |
| E\_GS\_UPDATE\_TOO\_BIG | 0x80830005 | O tamanho da atualização de salvamento é muito grande. O tamanho total de uma atualização do XGameSave deve ser menor que GS\_MAX\_BLOB\_SIZE (16 MB). |
| E\_GS\_QUOTA\_EXCEEDED | 0x80830006 | A cota de armazenamento do título para este usuário foi excedida. |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL | 0x80830007 | O buffer fornecido para a API era muito pequeno. |
| E\_GS\_BLOB\_NOT\_FOUND | 0x80830008 | O blob especificado não foi encontrado. |
| E\_GS\_NO\_SERVICE\_CONFIGURATION | 0x80830009 | O título não está configurado corretamente para o armazenamento conectado. Verifique se o SCID está correto e se o título está configurado no Partner Center. |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC | 0x8083000A | O contêiner ainda não está sincronizado. Verifique se o contêiner do XGameSave está sincronizado antes de enviar atualizações. |
| E\_GS\_CONTAINER\_SYNC\_FAILED | 0x8083000B | A sincronização do contêiner falhou. |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | A MSA do usuário ainda não é uma conta dos XBOX services. |
| E\_GS\_HANDLE\_EXPIRED | 0x8083000D | O identificador usado pela função expirou e deve ser obtido novamente. |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED | 0x8083000E | Esta função síncrona está sendo chamada em um thread sensível ao tempo e corre o risco de causar deadlocks. Use a implementação assíncrona. |
| E\_GS\_PROVIDER\_MISMATCH | 0x8083000F | O jogo está misturando chamadas de XGameSave e XGameSaveFiles, o que não é compatível. |

## Documentação conceitual

* [Visão geral dos salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-overview)
* [Guia do XGameSave](/pt-BR/build/core-features/common/game-save/xgamesave)
* [Depuração de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-debugging)

## Confira também

[Referência da API do sistema](/pt-BR/reference/system/gc-reference-system-toc)


## Related topics

- [XGameSave](/reference/system/xgamesave/xgamesave_members.md)
- [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSave API overview](/build/core-features/common/game-save/xgamesave.md)
- [XGameSave Provider Save method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)