> ## 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. # XGameSave > XGameSave # XGameSave L'API XGameSave est conçue pour permettre la création, le chargement, l'enregistrement et la gestion des états liés au jeu. La principale différence entre celle-ci et les implémentations précédentes est qu'elle fournit une API plate donnant accès à un modèle de programmation asynchrone qui permet à l'appelant de contrôler la gestion des threads et de la mémoire de l'API. ## Fonctions | Fonction | Description | | - | - | | [XGameSaveBlobInfoCallback](/fr/reference/system/xgamesave/functions/xgamesaveblobinfocallback) | Fonction de rappel permettant de récupérer les résultats de [XGameSaveEnumerateBlobInfo](/fr/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo). | | [XGameSaveCloseContainer](/fr/reference/system/xgamesave/functions/xgamesaveclosecontainer) | Ferme le XGameSaveContainer. | | [XGameSaveCloseProvider](/fr/reference/system/xgamesave/functions/xgamesavecloseprovider) | Libère les ressources détenues par le XGameSaveProvider. | | [XGameSaveCloseUpdate](/fr/reference/system/xgamesave/functions/xgamesavecloseupdate) | Ferme un XGameSaveUpdate. | | [XGameSaveContainerInfoCallback](/fr/reference/system/xgamesave/functions/xgamesavecontainerinfocallback) | Fonction de rappel d'un appel à [XGameSaveGetContainerInfo](/fr/reference/system/xgamesave/functions/xgamesavegetcontainerinfo). | | [XGameSaveCreateContainer](/fr/reference/system/xgamesave/functions/xgamesavecreatecontainer) | Crée un handle XGameSaveContainer. | | [XGameSaveCreateUpdate](/fr/reference/system/xgamesave/functions/xgamesavecreateupdate) | Crée une mise à jour qui sera ensuite soumise en appelant [XGameSaveSubmitUpdate](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdate). | | [XGameSaveDeleteContainer](/fr/reference/system/xgamesave/functions/xgamesavedeletecontainer) | Supprime un XGameSaveContainer du stockage cloud. | | [XGameSaveDeleteContainerAsync](/fr/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) | Supprime un XGameSaveContainer de manière asynchrone. | | [XGameSaveDeleteContainerResult](/fr/reference/system/xgamesave/functions/xgamesavedeletecontainerresult) | Récupère le résultat d'un appel à [XGameSaveDeleteContainerAsync](/fr/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) ; utilisez cette fonction pour vérifier la réussite de l'appel. | | [XGameSaveEnumerateBlobInfo](/fr/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) | Récupère les informations de blob pour le contenu d'un XGameSaveContainer. | | [XGameSaveEnumerateBlobInfoByName](/fr/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname) | Récupère les informations de blob pour le contenu d'un XGameSaveContainer, en se limitant aux blobs qui partagent un préfixe avec le paramètre blobNamePrefix. | | [XGameSaveEnumerateContainerInfo](/fr/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) | Récupère les informations de conteneur d'un XGameSaveProvider. | | [XGameSaveEnumerateContainerInfoByName](/fr/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) | Récupère les informations de conteneur d'un XGameSaveProvider. | | [XGameSaveGetContainerInfo](/fr/reference/system/xgamesave/functions/xgamesavegetcontainerinfo) | Récupère les informations des conteneurs d'un XGameSaveProvider. | | [XGameSaveGetRemainingQuota](/fr/reference/system/xgamesave/functions/xgamesavegetremainingquota) | Renvoie la quantité de données disponible pour le stockage à l'aide de l'API XGameSave. | | [XGameSaveGetRemainingQuotaAsync](/fr/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync) | Renvoie de manière asynchrone la quantité de données disponible pour le stockage à l'aide de l'API XGameSave. | | [XGameSaveGetRemainingQuotaResult](/fr/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult) | Récupère les résultats de la fonction [XGameSaveGetRemainingQuotaAsync](/fr/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync). | | [XGameSaveInitializeProvider](/fr/reference/system/xgamesave/functions/xgamesaveinitializeprovider) | Fournit et initialise un handle de fournisseur XGameSave. | | [XGameSaveInitializeProviderAsync](/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) | Fournit et initialise un handle de fournisseur XGameSave de manière asynchrone. | | [XGameSaveInitializeProviderResult](/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult) | Contient les résultats d'un appel à [XGameSaveInitializeProviderAsync](/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync). | | [XGameSaveReadBlobData](/fr/reference/system/xgamesave/functions/xgamesavereadblobdata) | Lit les données de blob d'un conteneur. | | [XGameSaveReadBlobDataAsync](/fr/reference/system/xgamesave/functions/xgamesavereadblobdataasync) | Lit les données XGameSaveBlob d'un XGameSaveContainer de manière asynchrone. | | [XGameSaveReadBlobDataResult](/fr/reference/system/xgamesave/functions/xgamesavereadblobdataresult) | Récupère les résultats d'un appel à [XGameSaveReadBlobDataAsync](/fr/reference/system/xgamesave/functions/xgamesavereadblobdataasync). | | [XGameSaveSubmitBlobDelete](/fr/reference/system/xgamesave/functions/xgamesavesubmitblobdelete) | Ajoute une action de suppression à un XGameSaveUpdate de sauvegarde de jeu. | | [XGameSaveSubmitBlobWrite](/fr/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) | Ajoute une action d'écriture à un XGameSaveUpdate. | | [XGameSaveSubmitUpdate](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdate) | Soumet une mise à jour au service XGameSave. Met à jour les blobs d'un conteneur. | | [XGameSaveSubmitUpdateAsync](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) | Soumet une mise à jour au service XGameSave de manière asynchrone. Met à jour les blobs d'un conteneur. | | [XGameSaveSubmitUpdateResult](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdateresult) | Récupère le résultat de l'appel à [XGameSaveSubmitUpdateAsync](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdateasync). | ## Structures | Structure | Description | | - | - | | [XGameSaveBlob](/fr/reference/system/xgamesave/structs/xgamesaveblob) | Unité d'information du stockage XGameSave. Réside dans un XGameSaveContainer. | | [XGameSaveBlobInfo](/fr/reference/system/xgamesave/structs/xgamesaveblobinfo) | Informations sur le XGameSaveBlob. | | [XGameSaveContainerInfo](/fr/reference/system/xgamesave/structs/xgamesavecontainerinfo) | Informations sur un XGameSaveContainer. | ## Codes d'erreur Les codes d'erreur suivants peuvent être renvoyés par les API XGameSave. Pour obtenir la liste complète, consultez [Codes d'erreur](/fr/reference/errorcodes). Pour obtenir des conseils de dépannage détaillés, consultez [Débogage des sauvegardes de jeu](/fr/build/core-features/common/game-save/game-saves-debugging). | Code | Valeur | Description | | - | - | - | | E\_GS\_INVALID\_CONTAINER\_NAME | 0x80830001 | Le nom du conteneur n'est pas valide. Les caractères valides pour un nom de conteneur sont les lettres majuscules/minuscules, les chiffres, les traits de soulignement et les barres obliques. | | E\_GS\_NO\_ACCESS | 0x80830002 | L'opération a échoué, car le titre n'a pas accès aux espaces de stockage du conteneur. Vérifiez que le SCID et le TitleId sont correctement configurés. | | E\_GS\_OUT\_OF\_LOCAL\_STORAGE | 0x80830003 | L'appareil ne dispose pas d'une capacité de stockage suffisante pour enregistrer le jeu. | | E\_GS\_USER\_CANCELED | 0x80830004 | L'utilisateur a annulé le téléchargement de ses sauvegardes de jeu. | | E\_GS\_UPDATE\_TOO\_BIG | 0x80830005 | La taille de la mise à jour de sauvegarde est trop importante. La taille totale d'une mise à jour XGameSave doit être inférieure à GS\_MAX\_BLOB\_SIZE (16 Mo). | | E\_GS\_QUOTA\_EXCEEDED | 0x80830006 | Le quota de stockage du titre pour cet utilisateur a été dépassé. | | E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL | 0x80830007 | La mémoire tampon fournie à l'API était trop petite. | | E\_GS\_BLOB\_NOT\_FOUND | 0x80830008 | Le blob spécifié est introuvable. | | E\_GS\_NO\_SERVICE\_CONFIGURATION | 0x80830009 | Le titre n'est pas correctement configuré pour le stockage connecté. Vérifiez que le SCID est correct et que le titre est configuré dans Partner Center. | | E\_GS\_CONTAINER\_NOT\_IN\_SYNC | 0x8083000A | Le conteneur n'est pas encore synchronisé. Assurez-vous que le conteneur XGameSave est synchronisé avant de soumettre des mises à jour. | | E\_GS\_CONTAINER\_SYNC\_FAILED | 0x8083000B | La synchronisation du conteneur a échoué. | | E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | Le MSA de l'utilisateur n'est pas encore un compte XBOX services. | | E\_GS\_HANDLE\_EXPIRED | 0x8083000D | Le handle utilisé par la fonction a expiré et doit être réacquis. | | E\_GS\_ASYNC\_FUNCTION\_REQUIRED | 0x8083000E | Cette fonction synchrone est appelée sur un thread sensible au temps et risque de provoquer des interblocages. Utilisez plutôt l'implémentation asynchrone. | | E\_GS\_PROVIDER\_MISMATCH | 0x8083000F | Le jeu mélange des appels XGameSave et XGameSaveFiles, ce qui n'est pas pris en charge. | ## Documentation conceptuelle * [Vue d'ensemble des sauvegardes de jeu](/fr/build/core-features/common/game-save/game-saves-overview) * [Guide XGameSave](/fr/build/core-features/common/game-save/xgamesave) * [Débogage des sauvegardes de jeu](/fr/build/core-features/common/game-save/game-saves-debugging) ## Voir aussi [Référence des API système](/fr/reference/system/gc-reference-system-toc) ## Related topics - [XGameSave](/reference/system/xgamesave/xgamesave_members.md) - [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) - [XGameSave API overview](/build/core-features/common/game-save/xgamesave.md) - [XGameSave Provider Save method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) - [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)