Skip to main content

​
XGameSaveCreateContainer

Cria um identificador XGameSaveContainer.

​
Sintaxe

​
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

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.
A API XGameSave exige que o título tenha a ID do título e a ID de configuração de serviço (SCID)
configuradas corretamente para funcionar. Para obter mais informações sobre essas IDs necessárias, consulte Configurando áreas restritas para o desenvolvimento do XBOX Live. 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. 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.
Um contêiner não é finalizado até que XGameSaveSubmitUpdate ou 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.

​
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

​
Confira também

XGameSave
XGameSaveContainerInfo
XGameSaveBlob
Depuração de salvamentos de jogos
Last modified on October 6, 2026