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 SeriesDocumentation conceptuelle
Voir aussi
XGameSaveXGameSaveEnumerateContainerInfo
Débogage des sauvegardes de jeu
