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
Paramètres
provider _In_Type : XGameSaveProviderHandle XGameSaveProvider contenant les 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.
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 XGameSaveEnumerateContainerInfo si vous n’avez pas besoin de spécifier un préfixe pour les conteneurs énumérés. XGameSaveEnumerateContainerInfo retourne 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
