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

Récupère les informations des conteneurs pour un **XGameSaveProvider**. Si vous fournissez un préfixe, la fonction retourne uniquement les mots qui ont ce même préfixe.

## Syntaxe

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

### Paramètres

*provider*   \_In\_\
Type : XGameSaveProviderHandle

**XGameSaveProvider** contenant les [XGameSaveContainerInfo](/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo).

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

Préfixe qui sera utilisé pour rechercher, dans la liste des conteneurs, les noms de conteneurs correspondants.

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

Pointeur qui sera passé à la fonction de rappel.

*callback*   \_In\_\
Type : XGameSaveContainerInfoCallback\*

Fonction de rappel à exécuter pour chaque conteneur qui correspond au préfixe; retournez false pour arrêter l'énumération. Utilisez cette fonction pour collecter les [XGameSaveContainerInfo](/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo).

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

Utilisez cette fonction pour inspecter les conteneurs disponibles pour un utilisateur. Cela peut inclure des données qui doivent être affichées dans l'interface utilisateur. L'énumération de cet ensemble ne provoque pas de synchronisation pour un fournisseur SyncOnDemand et permet à l'appelant d'inspecter réellement l'état de synchronisation au moyen du champ needsSync de [XGameSaveContainerInfo](/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo). Toute lecture de données de blob ou utilisation d'un contexte de mise à jour sur un conteneur dont *needsSync* est défini à true force une synchronisation et peut potentiellement retourner diverses erreurs de synchronisation. Vous pouvez utiliser [XGameSaveEnumerateContainerInfo](/fr-CA/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) si vous n'avez pas besoin de spécifier un préfixe pour les conteneurs énumérés. [XGameSaveEnumerateContainerInfo](/fr-CA/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) retourne la liste complète des conteneurs 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); 
    } 
  
} 
```

## Configuration requise

**En-tête :** XGameSave.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XGameSave](/fr-CA/reference/system/xgamesave/xgamesave_members)\
[XGameSaveEnumerateContainerInfo](/fr-CA/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)\
[Débogage des sauvegardes de jeu](/fr-CA/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveEnumerateContainerInfo](/fr-CA/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md)
- [XGameSaveContainerInfoCallback](/fr-CA/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md)
- [XGameSaveContainerInfo](/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo.md)
- [XGameSaveGetContainerInfo](/fr-CA/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [Vue d'ensemble de l'API XGameSave](/fr-CA/build/core-features/common/game-save/xgamesave.md)