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 SeriesDocumentação conceitual
Confira também
XGameSaveXGameSaveEnumerateContainerInfo
Depuração de salvamentos de jogos
