Skip to main content

XGameSaveEnumerateContainerInfo

Récupère les informations des conteneurs pour un XGameSaveProvider.

Syntaxe

Paramètres

provider   _In_
Type : XGameSaveProviderHandle
Handle vers le XGameSaveProvider contenant les XGameSaveContainerInfo. 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; retournez 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 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. 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 XGameSaveEnumerateContainerInfoByName pour filtrer les conteneurs en spécifiant un préfixe qui doit correspondre avant que les informations d’un conteneur ne soient retournées.

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
XGameSaveEnumerateContainerInfoByName
XGameSaveContainerInfo
Débogage des sauvegardes de jeu
Last modified on October 6, 2026