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

# Referência de Microsoft.Xbox.Wrappers.XGameSave.Provider

> Referência para a classe Microsoft.Xbox.Wrappers.XGameSave.Provider, o principal tipo de gerenciamento para inicializar, carregar, salvar e consultar contêineres de salvamento.

# Microsoft.Xbox.Wrappers.XGameSave.Provider

A classe de gerenciamento principal do wrapper do **XGameSave**.

## Sintaxe

```cpp theme={null}
class Provider
```

## Métodos

| Método | Descrição |
| - | - |
| [Initialize](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md) | Inicializa o wrapper de jogos salvos e sincroniza todos os contêineres do usuário especificado. |
| [QueryContainers](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers.md) | Retorna um vetor de nomes de contêineres que correspondem ao prefixo de nome fornecido. |
| [QueryContainerBlobs](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainerblobs.md) | Retorna um vetor de objetos [BlobInfo](https://docs.xbox.com/pt-BR/reference/system/Wrappers/structs/blobinfo.md) que identificam os blobs (arquivos) no contêiner especificado. |
| [Load](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md) | Carrega os dados do blob (arquivo) fornecido, de dentro do contêiner especificado. |
| [Save](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) | Salva dados no blob (arquivo) especificado dentro do contêiner especificado. |
| [GetQuota](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota.md) | Retorna a quantidade de dados disponível para armazenamento usando o wrapper de jogos salvos. |
| [Delete(std::string&)](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md) | Exclui um contêiner junto com todos os seus blobs (arquivos). |
| [Delete(std::string&, std::string&)](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_string.md) | Exclui os blobs (arquivos) especificados do contêiner especificado. |
| [Delete(std::string&, BlobNames&)](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_blobnames.md) | Exclui um ou mais blobs (arquivos) do contêiner especificado. |

## Comentários

O wrapper simplificado do **XGameSave** é um conjunto de APIs que permite ler e gravar dados em nome de um usuário, para que sejam mantidos entre sessões de jogo e sincronizados perfeitamente com a nuvem em vários dispositivos. As APIs do wrapper se dividem em três categorias:

**Provedores**

`gs_provider_t` é o identificador que vincula um contexto de usuário a um jogo salvo. Ele é necessário para as interações com a API. Cada provedor pode conter vários contêineres, e cada provedor tem uma cota padrão de 256 MB. As operações do provedor incluem:

* Informações de cota
* Gerenciamento de contêineres
* Metadados do provedor (ID de configuração de serviço, UserContext)

**Contêineres**

Você pode usar contêineres para correlacionar logicamente dados em um grupo que pode ser gravado, atualizado e lido de forma atômica. As operações de contêiner incluem:

* Consultas sobre informações e status do contêiner
* Consultas sobre o conteúdo do contêiner
* Atualizações atômicas nos dados do contêiner

**Objetos binários grandes (blobs)**

Os blobs contêm os dados armazenados em um contêiner. A quantidade máxima de dados que um blob pode conter é de 16 MB.

* As operações de atualização e exclusão de blobs são projetadas para serem atômicas, de modo que um conjunto de alterações possa ser confirmado em uma única operação. Se qualquer parte falhar, toda a atualização falhará.

## Requisitos

**Cabeçalho:** xgamesavewrappers.hpp

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Microsoft.Xbox.Wrappers.XGameSave.Provider](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider.md)\
[Membros do wrapper do XGameSave](https://docs.xbox.com/pt-BR/reference/system/Wrappers/xgamesave_wrapper_members.md)\
[Padrão de design do observador](https://learn.microsoft.com/dotnet/standard/events/observer-design-pattern)


## Related topics

- [Save](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [Initialize](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [Load](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md)
- [QueryContainers](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers.md)
- [Delete(std::string&)](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md)