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

# 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] 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](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md). 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](https://docs.xbox.com/fr-CA/reference/system/xgamesave/structs/xgamesaveblob.md).
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](https://docs.xbox.com/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo.md).

> [!NOTE]
>
> Un conteneur n'est pas finalisé tant que [XGameSaveSubmitUpdate](https://docs.xbox.com/fr-CA/reference/system/xgamesave/functions/xgamesavesubmitupdate.md) ou [XGameSaveSubmitUpdateAsync](https://docs.xbox.com/fr-CA/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md) 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](https://docs.xbox.com/fr-CA/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname.md).

## 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](https://docs.xbox.com/fr-CA/reference/system/xgamesave/xgamesave_members.md)\
[XGameSaveContainerInfo](https://docs.xbox.com/fr-CA/reference/system/xgamesave/structs/xgamesavecontainerinfo.md)\
[XGameSaveBlob](https://docs.xbox.com/fr-CA/reference/system/xgamesave/structs/xgamesaveblob.md)\
[Débogage de Game Saves](https://docs.xbox.com/fr-CA/build/core-features/common/game-save/game-saves-debugging.md)


## Related topics

- [XGameSaveCloseContainer](https://docs.xbox.com/fr-CA/reference/system/xgamesave/functions/xgamesaveclosecontainer.md)
- [XGameSaveGetContainerInfo](https://docs.xbox.com/fr-CA/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [Vue d'ensemble de l'API XGameSave](https://docs.xbox.com/fr-CA/build/core-features/common/game-save/xgamesave.md)
- [XGameSave (contenu de l'API)](https://docs.xbox.com/fr-CA/reference/system/xgamesave/xgamesave_members.md)
- [Utilisation des wrappers C# pour les API du GDK dans votre projet Unity](https://docs.xbox.com/fr-CA/build/gdk-and-engines/unity/unity-api-wrappers.md)