> ## 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.

# XGameSaveEnumerateContainerInfoByName

> XGameSaveEnumerateContainerInfoByName

# XGameSaveEnumerateContainerInfoByName

Recupera la información de contenedores de un **XGameSaveProvider**. Si se proporciona un prefijo, la función devolverá únicamente los nombres que tengan ese mismo prefijo.

## Sintaxis

```cpp theme={null}
HRESULT XGameSaveEnumerateContainerInfoByName(  
         XGameSaveProviderHandle provider,  
         const char* containerNamePrefix,  
         void* context,  
         XGameSaveContainerInfoCallback* callback  
)  
```

### Parámetros

*provider*   \_In\_\
Tipo: XGameSaveProviderHandle

**XGameSaveProvider** que contiene la información de [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo).

*containerNamePrefix*   \_In\_opt\_z\_\
Tipo: char\*

Prefijo que se usará para buscar en la lista de contenedores los nombres de contenedor coincidentes.

*context*   \_In\_opt\_\
Tipo: void\*

Puntero que se pasará a la función de devolución de llamada.

*callback*   \_In\_\
Tipo: XGameSaveContainerInfoCallback\*

La función de devolución de llamada que se ejecutará para cada contenedor que coincida con el prefijo; devuelva false para detener la enumeración. Use esta función para recopilar la información de [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo).

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

Use esta función para inspeccionar qué contenedores están disponibles para un usuario. Esto puede incluir datos que se necesitan mostrar en la experiencia de usuario. Enumerar este conjunto no provocará una sincronización en un proveedor SyncOnDemand y permitirá al autor de la llamada inspeccionar realmente el estado de sincronización mediante el campo needsSync de [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo). Cualquier lectura de datos de blobs o uso de un contexto de actualización en un contenedor que tenga *needsSync* establecido en true forzará una sincronización y podría devolver varios errores de sincronización. Puede usar [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) si no necesita especificar un prefijo para los contenedores enumerados. [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) devolverá la lista completa de contenedores disponibles.

```cpp theme={null}
// Enumerate Container List by prefix, if no prefix is supplied it is 
// the same as calling XGameSaveEnumerateContainerInfo. 
// NOTE: this should be safe to call from a time critical thread 
// but the we are at the mercy of the callback. 
void Sample::_EnumerateContainerInfoByName(const char* prefix) 
{ 
    HRESULT hr = XGameSaveEnumerateContainerInfoByName(_provider, prefix, this, 
        [](const XGameSaveContainerInfo* container, void* context) 
    { 
        auto self = reinterpret_cast<Sample*>(context); 
        self->_UpdateContainerList(container); 
        return true; 
    }); 
    if (FAILED(hr)) 
    { 
        _HandleContainerErrors(prefix, hr); 
    } 
  
} 
```

## Requisitos

**Encabezado:** XGameSave.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Subprocesos con dependencia temporal](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)\
[Depuración de partidas guardadas](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveEnumerateContainerInfo](/es/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md)
- [XGameSaveContainerInfoCallback](/es/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md)
- [XGameSaveContainerInfo](/es/reference/system/xgamesave/structs/xgamesavecontainerinfo.md)
- [XGameSaveGetContainerInfo](/es/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [Información general de la API XGameSave](/es/build/core-features/common/game-save/xgamesave.md)