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

# Load

> Referência para o método Provider.Load do wrapper do XGameSave, que lê os bytes de um blob (arquivo) nomeado de um contêiner de salvamento para a memória do jogo.

# Microsoft.Xbox.Wrappers.XGameSave.Provider.Load

Carrega os dados do blob (arquivo) fornecido, de dentro do contêiner especificado.

## Sintaxe

```cpp theme={null}
BlobData Load(const std::string& containerName,
              const std::string& blobName );
```

### Parâmetros

*containerName*   \_In\_\
Tipo: std::string

O nome do contêiner.

*blobName*  \_In\_\
Tipo: std::string

O nome do blob do qual carregar os dados.

### Valor retornado

Tipo: BlobData

Este método retorna um vetor que contém uma cópia byte a byte do conteúdo do blob.

### Exemplo

O código de exemplo a seguir demonstra como usar o método **Load**.

```cpp theme={null}
using Microsoft::Xbox::Wrappers::GameSave;

Provider provider = new Provider();

if(SUCCEEDED(provider->Initialize(userHandle, mySCID))
{
   std::vector<std::string> containers = provider->QueryContainers("Save slot 1");
   
   if(containers.size() == 1)
   {
      BlobData data = provider->Load("Save_slot_1", "progress");
      
      if(!data.empty())
      {
         // Read the data into the game.
      }
      else
      {
         // Unexpected because there should be
         // only one blob in the container.
      }
   }
}
```

## Comentários

Este método gera uma exceção se você chamá-lo no thread da interface do usuário.

Se não houver correspondência para os nomes do contêiner e do blob, o vetor retornado estará vazio.

Você deve chamar o método [Initialize](https://docs.xbox.com/pt-BR/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md) antes de poder chamar qualquer outro método da classe `Provider`.

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


## Related topics

- [LoadPipeline](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary1/methods/id3d12pipelinelibrary1_loadpipeline_public.md)
- [LoadGraphicsPipeline](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadgraphicspipeline_public.md)
- [LoadComputePipeline](https://docs.xbox.com/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadcomputepipeline_public.md)
- [ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH](https://docs.xbox.com/pt-BR/reference/audio/acphal/structs/acp_command_load_shape_flowgraph.md)
- [TurboLoading do Economy V2](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)