Skip to main content

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

Paramètres

provider   _In_
Type : XGameSaveProviderHandle
XGameSaveProvider contenant les 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.

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. 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 si vous n’avez pas besoin de spécifier de préfixe pour les conteneurs énumérés. XGameSaveEnumerateContainerInfo renvoie la liste complète des conteneurs disponibles.

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

Voir aussi

XGameSave
XGameSaveEnumerateContainerInfo
Débogage des sauvegardes de jeu
Last modified on October 6, 2026