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

# XGameSaveCreateContainer

> XGameSaveCreateContainer

# XGameSaveCreateContainer

Cria um identificador XGameSaveContainer.

## Sintaxe

```cpp theme={null}
HRESULT XGameSaveCreateContainer(  
         XGameSaveProviderHandle provider,  
         const char* containerName,  
         XGameSaveContainerHandle* containerContext  
)  
```

### Parâmetros

*provider*   \_In\_\
Tipo: XGameSaveProviderHandle

Identificador do XGameSaveProvider que criará o contêiner.

*containerName*   \_In\_z\_\
Tipo: char\*

Nome do contêiner a ser criado.

Os caracteres válidos para a parte do caminho do nome do contêiner (até a barra final, inclusive) incluem
letras maiúsculas (A-Z), letras minúsculas (a-z), números (0-9), sublinhado (\_) e barra (/). A parte do
caminho pode estar vazia.

Os caracteres válidos para a parte do nome do arquivo (tudo após a barra final) incluem letras maiúsculas (A-Z),
letras minúsculas (a-z), números (0-9), sublinhado (\_), ponto (.) e hífen (-). O nome do arquivo não pode estar vazio,
terminar com ponto nem conter dois pontos consecutivos.

O comprimento máximo do nome do contêiner é de 256 caracteres.

*containerContext*   \_Outptr\_result\_nullonfailure\_\
Tipo: XGameSaveContainerHandle\*

Identificador do XGameSaveContainer a ser retornado por esta chamada de função.

### Valor retornado

Tipo: HRESULT

Resultado da função. Se containerName for inválido, a função retornará E\_GS\_INVALID\_CONTAINER\_NAME (0x80830001).

## Comentários

<Note>Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

<Note>A API XGameSave exige que o título tenha a ID do título e a ID de configuração de serviço (SCID)</Note>
configuradas corretamente para funcionar. Para obter mais informações sobre essas IDs necessárias, consulte [Configurando áreas restritas para o desenvolvimento do XBOX
Live](/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes). Seu jogo deve estar habilitado para XBOX Live no Partner Center.

Se você não configurar a SCID e a ID do título corretamente, suas chamadas de API XSaveGame falharão com o seguinte código de erro:

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.

XGameSaveCreateContainer é usada tanto para criar um novo contêiner quanto para acessar um contêiner criado anteriormente, usando o nome
como identificador. Um contêiner de salvamento de jogo mantém informações sobre um jogador na forma de [XGameSaveBlobs](/pt-BR/reference/system/xgamesave/structs/xgamesaveblob).
Blobs são dados específicos associados a um jogador; esses dados incluem um nome e um valor, além de outras informações para ajudar a
ler os dados do blob. Você pode encontrar a composição de um **XGameSaveContainer** na
struct [XGameSaveContainerInfo](/pt-BR/reference/system/xgamesave/structs/xgamesavecontainerinfo).

<Note>Um contêiner não é finalizado até que [XGameSaveSubmitUpdate](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdate) ou [XGameSaveSubmitUpdateAsync](/pt-BR/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) tenha sido chamada para o contêiner. Até que a API de atualização seja chamada, o contêiner não será incluído nos resultados de [XGameSaveEnumerateContainerInfoByName](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname).</Note>

## Requisitos

**Cabeçalho:** XGameSave.h

**Biblioteca:** xgameruntime.lib

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

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XGameSave](/pt-BR/reference/system/xgamesave/xgamesave_members)\
[XGameSaveContainerInfo](/pt-BR/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[XGameSaveBlob](/pt-BR/reference/system/xgamesave/structs/xgamesaveblob)\
[Depuração de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveCreateContainer](/reference/system/xgamesave/functions/xgamesavecreatecontainer.md)
- [XGameSaveCloseContainer](/reference/system/xgamesave/functions/xgamesaveclosecontainer.md)