> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSave (contenu de l'API)

> 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](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveblobinfocallback.md) | Fonction de rappel permettant de récupérer les résultats de [XGameSaveEnumerateBlobInfo](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md). |
| [XGameSaveCloseContainer](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveclosecontainer.md) | Ferme le XGameSaveContainer. |
| [XGameSaveCloseProvider](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavecloseprovider.md) | Libère les ressources détenues par le XGameSaveProvider. |
| [XGameSaveCloseUpdate](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavecloseupdate.md) | Ferme un XGameSaveUpdate. |
| [XGameSaveContainerInfoCallback](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md) | Fonction de rappel d'un appel à [XGameSaveGetContainerInfo](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md). |
| [XGameSaveCreateContainer](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavecreatecontainer.md) | Crée un handle XGameSaveContainer. |
| [XGameSaveCreateUpdate](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavecreateupdate.md) | Crée une mise à jour qui sera ensuite soumise en appelant [XGameSaveSubmitUpdate](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavesubmitupdate.md). |
| [XGameSaveDeleteContainer](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavedeletecontainer.md) | Supprime un XGameSaveContainer du stockage cloud. |
| [XGameSaveDeleteContainerAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md) | Supprime un XGameSaveContainer de manière asynchrone. |
| [XGameSaveDeleteContainerResult](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavedeletecontainerresult.md) | Récupère le résultat d'un appel à [XGameSaveDeleteContainerAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md) ; utilisez cette fonction pour vérifier la réussite de l'appel. |
| [XGameSaveEnumerateBlobInfo](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md) | Récupère les informations de blob pour le contenu d'un XGameSaveContainer. |
| [XGameSaveEnumerateBlobInfoByName](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname.md) | 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](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md) | Récupère les informations de conteneur d'un XGameSaveProvider. |
| [XGameSaveEnumerateContainerInfoByName](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname.md) | Récupère les informations de conteneur d'un XGameSaveProvider. |
| [XGameSaveGetContainerInfo](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md) | Récupère les informations des conteneurs d'un XGameSaveProvider. |
| [XGameSaveGetRemainingQuota](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavegetremainingquota.md) | Renvoie la quantité de données disponible pour le stockage à l'aide de l'API XGameSave. |
| [XGameSaveGetRemainingQuotaAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md) | Renvoie de manière asynchrone la quantité de données disponible pour le stockage à l'aide de l'API XGameSave. |
| [XGameSaveGetRemainingQuotaResult](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md) | Récupère les résultats de la fonction [XGameSaveGetRemainingQuotaAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md). |
| [XGameSaveInitializeProvider](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveinitializeprovider.md) | Fournit et initialise un handle de fournisseur XGameSave. |
| [XGameSaveInitializeProviderAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md) | Fournit et initialise un handle de fournisseur XGameSave de manière asynchrone. |
| [XGameSaveInitializeProviderResult](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult.md) | Contient les résultats d'un appel à [XGameSaveInitializeProviderAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md). |
| [XGameSaveReadBlobData](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavereadblobdata.md) | Lit les données de blob d'un conteneur. |
| [XGameSaveReadBlobDataAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md) | Lit les données XGameSaveBlob d'un XGameSaveContainer de manière asynchrone. |
| [XGameSaveReadBlobDataResult](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavereadblobdataresult.md) | Récupère les résultats d'un appel à [XGameSaveReadBlobDataAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md). |
| [XGameSaveSubmitBlobDelete](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavesubmitblobdelete.md) | Ajoute une action de suppression à un XGameSaveUpdate de sauvegarde de jeu. |
| [XGameSaveSubmitBlobWrite](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavesubmitblobwrite.md) | Ajoute une action d'écriture à un XGameSaveUpdate. |
| [XGameSaveSubmitUpdate](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavesubmitupdate.md) | Soumet une mise à jour au service XGameSave. Met à jour les blobs d'un conteneur. |
| [XGameSaveSubmitUpdateAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md) | Soumet une mise à jour au service XGameSave de manière asynchrone. Met à jour les blobs d'un conteneur. |
| [XGameSaveSubmitUpdateResult](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavesubmitupdateresult.md) | Récupère le résultat de l'appel à [XGameSaveSubmitUpdateAsync](https://docs.xbox.com/fr/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md). |

## Structures

| Structure | Description |
| - | - |
| [XGameSaveBlob](https://docs.xbox.com/fr/reference/system/xgamesave/structs/xgamesaveblob.md) | Unité d'information du stockage XGameSave. Réside dans un XGameSaveContainer. |
| [XGameSaveBlobInfo](https://docs.xbox.com/fr/reference/system/xgamesave/structs/xgamesaveblobinfo.md) | Informations sur le XGameSaveBlob. |
| [XGameSaveContainerInfo](https://docs.xbox.com/fr/reference/system/xgamesave/structs/xgamesavecontainerinfo.md) | 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](https://docs.xbox.com/fr/reference/errorcodes.md). Pour obtenir des conseils de dépannage détaillés, consultez [Débogage des sauvegardes de jeu](https://docs.xbox.com/fr/build/core-features/common/game-save/game-saves-debugging.md).

| 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](https://docs.xbox.com/fr/build/core-features/common/game-save/game-saves-overview.md)
* [Guide XGameSave](https://docs.xbox.com/fr/build/core-features/common/game-save/xgamesave.md)
* [Débogage des sauvegardes de jeu](https://docs.xbox.com/fr/build/core-features/common/game-save/game-saves-debugging.md)

## Voir aussi

[Référence des API système](https://docs.xbox.com/fr/reference/system/gc-reference-system-toc.md)


## Related topics

- [Référence du wrapper XGameSave (contenu de l'API)](https://docs.xbox.com/fr/reference/system/Wrappers/xgamesave_wrapper_members.md)
- [Vue d'ensemble de l'API XGameSave](https://docs.xbox.com/fr/build/core-features/common/game-save/xgamesave.md)
- [Débogage de Game Saves](https://docs.xbox.com/fr/build/core-features/common/game-save/game-saves-debugging.md)
- [Outils Game Saves](https://docs.xbox.com/fr/build/core-features/common/game-save/game-saves-tools.md)
- [Systèmes de stockage de Game Saves](https://docs.xbox.com/fr/build/core-features/common/game-save/game-saves-storage-systems.md)