Skip to main content

​
XGameSaveCreateContainer

Crée un handle XGameSaveContainer.

​
Syntaxe

​
Paramètres

provider   _In_
Type : XGameSaveProviderHandle Handle du XGameSaveProvider qui créera le conteneur. containerName   _In_z_
Type : char* Nom du conteneur à créer. Les caractères valides pour la portion chemin du nom du conteneur (jusqu’à la dernière barre oblique, inclusivement) comprennent les lettres majuscules (A-Z), les lettres minuscules (a-z), les chiffres (0-9), le trait de soulignement (_) et la barre oblique (/). La portion chemin peut être vide. Les caractères valides pour la portion 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 du conteneur est de 256 caractères. containerContext   _Outptr_result_nullonfailure_
Type : XGameSaveContainerHandle* Handle du XGameSaveContainer à retourner 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

Cette fonction ne peut pas être appelée en toute sécurité sur un thread à délai critique. Pour plus d’informations, consultez Threads à délai critique.
L’API XGameSave exige que l’ID de titre et l’ID de configuration de service (SCID) de votre titre soient
correctement configurés pour fonctionner. Pour plus d’informations sur ces ID requis, consultez Configuration des bacs à sable 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 sert à la fois à créer un nouveau conteneur et à 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 forme de XGameSaveBlobs. Les blobs sont des données propres à un joueur; ces données comprennent un nom et une valeur, ainsi que d’autres informations qui aident à lire les données du blob. Vous trouverez la composition d’un XGameSaveContainer dans la structure XGameSaveContainerInfo.
Un conteneur n’est pas finalisé tant que XGameSaveSubmitUpdate ou XGameSaveSubmitUpdateAsync n’a pas été appelée pour ce conteneur. Tant que l’API de mise à jour n’a pas été appelée, le conteneur ne figurera 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 de Game Saves
Last modified on October 6, 2026