Skip to main content

XGameSaveEnumerateContainerInfoByName

Recupera as informações de contêiner de um XGameSaveProvider. Fornecer um prefixo fará com que a função retorne somente palavras que tenham esse mesmo prefixo.

Sintaxe

Parâmetros

provider   _In_
Tipo: XGameSaveProviderHandle
XGameSaveProvider que contém o XGameSaveContainerInfo. containerNamePrefix   _In_opt_z_
Tipo: char*
Um prefixo que será usado para pesquisar na lista de contêineres os nomes de contêiner correspondentes. 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 que corresponde ao prefixo; 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 XGameSaveEnumerateContainerInfo se não precisar especificar um prefixo para os contêineres enumerados. XGameSaveEnumerateContainerInfo retornará a lista completa de contêineres disponíveis.

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