Skip to main content

XGameSaveEnumerateContainerInfo

Recupera as informações de contêiner de um XGameSaveProvider.

Sintaxe

Parâmetros

provider   _In_
Tipo: XGameSaveProviderHandle
Identificador para o XGameSaveProvider que contém o XGameSaveContainerInfo. context   _In_opt_
Tipo: void*
Ponteiro que será passado para a função de retorno de chamada. callback   _In_
Tipo: XGameSaveContainerInfoCallback*
A função de retorno de chamada a ser executada para cada contêiner; retorne false para interromper a enumeração. Use esta função para coletar o XGameSaveContainerInfo.

Valor retornado

Tipo: HRESULT Resultado da função

Comentários

Use esta função para inspecionar quais contêineres estão disponíveis para um usuário. Isso pode incluir dados que precisam ser mostrados na UX. Enumerar este conjunto não causará uma sincronização para um provedor SyncOnDemand e permitirá que o chamador realmente inspecione o status da sincronização por meio do campo needsSync de XGameSaveContainerInfo. Qualquer leitura de dados de blob ou uso de um contexto de atualização em um contêiner que tenha needsSync definido como true forçará uma sincronização e poderá retornar vários erros de sincronização. Você pode usar XGameSaveEnumerateContainerInfoByName para filtrar os contêineres especificando um prefixo que deve ser correspondido antes que as informações de um contêiner sejam retornadas.

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