Skip to main content

​
XGameSaveCreateContainer

Crée un handle XGameSaveContainer.

​
Syntaxe

​
Paramètres

provider   _In_
Type : XGameSaveProviderHandle Handle du XGameSaveProvider qui va créer le conteneur. containerName   _In_z_
Type : char* Nom du conteneur à créer. Les caractères valides pour la partie chemin du nom de conteneur (jusqu’à la dernière barre oblique incluse) comprennent les lettres majuscules (A-Z), les lettres minuscules (a-z), les chiffres (0-9), le trait de soulignement (_) et la barre oblique (/). La partie chemin peut être vide. Les caractères valides pour la partie nom de fichier (tout ce qui suit la dernière barre oblique) comprennent les lettres majuscules (A-Z), les lettres minuscules (a-z), les chiffres (0-9), le trait de soulignement (_), le point (.) et le trait d’union (-). Le nom de fichier ne peut pas être vide, se terminer par un point ni contenir deux points consécutifs. La longueur maximale du nom de conteneur est de 256 caractères. containerContext   _Outptr_result_nullonfailure_
Type : XGameSaveContainerHandle* Handle du XGameSaveContainer retourné par cet appel de fonction.

​
Valeur de retour

Type : HRESULT Résultat de la fonction. Si containerName n’est pas valide, la fonction retourne E_GS_INVALID_CONTAINER_NAME (0x80830001).

​
Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread à contrainte de temps. Pour plus d’informations, consultez Threads à contrainte de temps.
Pour fonctionner, l’API XGameSave nécessite que l’ID de titre et l’ID de configuration de service (SCID) de votre titre
soient correctement configurés. Pour plus d’informations sur ces ID requis, consultez Configuration des sandbox pour le développement XBOX Live. Votre jeu doit être activé pour XBOX Live dans Partner Center. Si vous ne configurez pas correctement votre SCID et votre ID de titre, vos appels à l’API XSaveGame échoueront avec le code d’erreur suivant : E_GS_NO_ACCESS - 0x80830002 - L’opération a échoué, car le titre n’a pas accès aux espaces de stockage du conteneur. XGameSaveCreateContainer est utilisée à la fois pour créer un conteneur et pour accéder à un conteneur créé précédemment en utilisant le nom comme identificateur. Un conteneur de sauvegarde de jeu contient des informations sur un joueur sous la forme de XGameSaveBlobs. Les blobs sont des données spécifiques associées à un joueur ; ces données comprennent un nom et une valeur, ainsi que d’autres informations facilitant la lecture des données du blob. Vous trouverez la composition d’un XGameSaveContainer dans la structure XGameSaveContainerInfo.
Un conteneur n’est finalisé qu’une fois que XGameSaveSubmitUpdate ou XGameSaveSubmitUpdateAsync a été appelée pour ce conteneur. Tant que l’API de mise à jour n’a pas été appelée, le conteneur n’apparaît pas dans les résultats de XGameSaveEnumerateContainerInfoByName.

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