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

# Referência da classe Provider do wrapper do XGameSave

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

<a id="syntaxSection" />

## Sintaxe

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

## Métodos

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

<a id="remarksSection" />

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

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xgamesavewrappers.hpp

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

<a id="seealsoSection" />

## Confira também

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


## Related topics

- [Referencia del método Save de XGameSave Provider](/es/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [Referencia del método Initialize de XGameSave Provider](/es/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [Referencia del método Load de XGameSave Provider](/es/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md)
- [Referencia del método GetQuota de XGameSave Provider](/es/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota.md)
- [Referencia de la estructura BlobInfo del contenedor XGameSave](/es/reference/system/Wrappers/structs/blobinfo.md)