> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSaveEnumerateContainerInfo

> XGameSaveEnumerateContainerInfo

# XGameSaveEnumerateContainerInfo

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

## Sintaxe

```cpp theme={null}
HRESULT XGameSaveEnumerateContainerInfo(  
         XGameSaveProviderHandle provider,  
         void* context,  
         XGameSaveContainerInfoCallback* callback  
)  
```

### Parâmetros

*provider*   \_In\_\
Tipo: XGameSaveProviderHandle

Identificador para o **XGameSaveProvider** que contém o [XGameSaveContainerInfo](/pt-BR/reference/system/xgamesave/structs/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](/pt-BR/reference/system/xgamesave/structs/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](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) 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

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XGameSave](/pt-BR/reference/system/xgamesave/xgamesave_members)\
[XGameSaveEnumerateContainerInfoByName](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)\
[XGameSaveContainerInfo](/pt-BR/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[Depuração de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md)
- [XGameSaveEnumerateContainerInfoByName](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname.md)