> ## 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.

# XGameSaveCreateContainer

> XGameSaveCreateContainer

# XGameSaveCreateContainer

Crée un handle XGameSaveContainer.

## Syntaxe

```cpp theme={null}
HRESULT XGameSaveCreateContainer(  
         XGameSaveProviderHandle provider,  
         const char* containerName,  
         XGameSaveContainerHandle* containerContext  
)  
```

### 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

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

<Note>Pour fonctionner, l'API XGameSave nécessite que l'ID de titre et l'ID de configuration de service (SCID) de votre titre</Note>
soient correctement configurés. Pour plus d'informations sur ces ID requis, consultez [Configuration des sandbox pour le développement XBOX
Live](/fr/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes). 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](/fr/reference/system/xgamesave/structs/xgamesaveblob).
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](/fr/reference/system/xgamesave/structs/xgamesavecontainerinfo).

<Note>Un conteneur n'est finalisé qu'une fois que [XGameSaveSubmitUpdate](/fr/reference/system/xgamesave/functions/xgamesavesubmitupdate) ou [XGameSaveSubmitUpdateAsync](/fr/reference/system/xgamesave/functions/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](/fr/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname).</Note>

## 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

* [Threads à contrainte de temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XGameSave](/fr/reference/system/xgamesave/xgamesave_members)\
[XGameSaveContainerInfo](/fr/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[XGameSaveBlob](/fr/reference/system/xgamesave/structs/xgamesaveblob)\
[Débogage des sauvegardes de jeu](/fr/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveCreateContainer](/reference/system/xgamesave/functions/xgamesavecreatecontainer.md)
- [XGameSaveCloseContainer](/reference/system/xgamesave/functions/xgamesaveclosecontainer.md)
- [XGameSaveGetContainerInfo](/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [XGameSave API overview](/build/core-features/common/game-save/xgamesave.md)
- [XGameSave](/reference/system/xgamesave/xgamesave_members.md)