> ## 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 de conteneur d'un **XGameSaveProvider**. Si vous fournissez un préfixe, la fonction renvoie 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/reference/system/xgamesave/structs/xgamesavecontainerinfo).

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

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

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

Pointeur qui sera transmis à la fonction de rappel.

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

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

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

Utilisez cette fonction pour examiner les conteneurs disponibles pour un utilisateur. Cela peut inclure des données qui doivent être affichées dans l'expérience utilisateur. L'énumération de cet ensemble ne déclenche pas de synchronisation pour un fournisseur SyncOnDemand et permet à l'appelant d'examiner l'état de synchronisation via le champ needsSync de [XGameSaveContainerInfo](/fr/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* a la valeur true force une synchronisation et peut renvoyer diverses erreurs de synchronisation. Vous pouvez utiliser [XGameSaveEnumerateContainerInfo](/fr/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) si vous n'avez pas besoin de spécifier de préfixe pour les conteneurs énumérés. [XGameSaveEnumerateContainerInfo](/fr/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) renvoie 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 à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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


## Related topics

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