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

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

<Note>L'API XGameSave exige que l'ID de titre et l'ID de configuration de service (SCID) de votre titre soient</Note>
correctement configurés pour fonctionner. Pour plus d'informations sur ces ID requis, consultez [Configuration des bacs à sable pour le développement XBOX
Live](/fr-CA/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 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](/fr-CA/reference/system/xgamesave/structs/xgamesaveblob).
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](/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo).

<Note>Un conteneur n'est pas finalisé tant que [XGameSaveSubmitUpdate](/fr-CA/reference/system/xgamesave/functions/xgamesavesubmitupdate) ou [XGameSaveSubmitUpdateAsync](/fr-CA/reference/system/xgamesave/functions/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](/fr-CA/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 à délai critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XGameSave](/fr-CA/reference/system/xgamesave/xgamesave_members)\
[XGameSaveContainerInfo](/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[XGameSaveBlob](/fr-CA/reference/system/xgamesave/structs/xgamesaveblob)\
[Débogage de Game Saves](/fr-CA/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)