Skip to main content

XGameSaveGetContainerInfo

Recupera informações dos contêineres em um XGameSaveProvider.

Sintaxe

Parâmetros

provider   _In_
Tipo: XGameSaveProviderHandle
Um identificador de XGameSaveProvider com o contêiner desejado. containerName   _In_z_
Tipo: char*
Nome do contêiner sobre o qual recuperar informações; retornará apenas um resultado, se encontrado. Se mais de um contêiner for desejado, use XGameSaveEnumerateContainerInfo ou XGameSaveEnumerateContainerInfoByName. context   _In_opt_
Tipo: void*
Ponteiro para o objeto de chamada para contexto. callback   _In_
Tipo: XGameSaveContainerInfoCallback*
Função de retorno de chamada para determinar os resultados da chamada de XGameSaveContainerInfo e coletar dados dela.

Valor retornado

Tipo: HRESULT Resultado da função

Erros comuns

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_USER_CANCELED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Comentários

Não é seguro chamar esta função em uma thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Um contêiner é uma coleção de metadados e um ponto de referência para o conjunto de blobs dentro dele. Se o nome do contêiner for conhecido com antecedência, será possível usar esta API para retornar as informações apenas desse contêiner. Isso é útil para trazer informações específicas sobre um jogador em vez de solicitar todas elas sempre que você precisar de informações. Você pode encontrar a composição de um XGameSaveContainer na struct XGameSaveContainerInfo.

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
XGameSaveCreateContainer
XGameSaveContainerInfo
Depuração de salvamentos de jogos
Last modified on October 6, 2026