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

# XSystemGetXboxLiveSandboxId

> XSystemGetXboxLiveSandboxId

# XSystemGetXboxLiveSandboxId

Récupère l'ID du bac à sable XBOX Live.

## Syntaxe

```cpp theme={null}
HRESULT XSystemGetXboxLiveSandboxId(  
         size_t sandboxIdSize,  
         char* sandboxId,  
         size_t* sandboxIdUsed  
)  
```

### Paramètres

*sandboxIdSize*   \_In\_<br />Type : size\_t

Taille de *sandboxId*, en octets. Cette valeur doit être supérieure ou égale à la constante **XSystemXboxLiveSandboxIdMaxBytes** définie dans XSystem.h.

*sandboxId*   \_Out\_writes\_bytes\_to\_(sandboxIdSize,\*sandboxIdUsed)<br />Type : char\*

Mémoire tampon de caractères qui recevra l'ID du bac à sable.

*sandboxIdUsed*   \_Out\_opt\_<br />Type : size\_t\*

Taille réelle, en octets, de la mémoire tampon *sandboxId* retournée.

### Valeur de retour

Type : [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retourne **S\_OK** en cas de réussite ; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr/reference/errorcodes). Si la fonction échoue parce que *sandboxIdSize* est défini sur une valeur inférieure à **XSystemXboxLiveSandboxIdMaxBytes**, la valeur de retour est **HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)**.

## Remarques

Avec le TitleID et l'ID de configuration de service (SCID), l'ID du bac à sable est essentiel au développement de titres et d'applications XBOX Live. L'ID du bac à sable identifie votre bac à sable, qui assure l'isolation du contenu pour votre kit de développement pendant le développement. L'isolation du contenu vous garantit un environnement propre pour développer et tester votre titre.

<Note>
  Les ID de bac à sable respectent la casse.
</Note>

Pour les appareils XBOX et PC, l'ID du bac à sable est stocké sur l'appareil. Si l'ID du bac à sable est introuvable, ou si vous n'avez pas l'autorisation d'y accéder, l'ID du bac à sable prend par défaut la valeur 'RETAIL'.

Cette fonction retourne également 'RETAIL' si votre jeu s'exécute effectivement dans l'environnement retail.

## Configuration requise

**En-tête :** XSystem.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

[Configuration des paramètres du kit de développement (rubrique sous NDA)](/fr/home/setup-install/dev-kit-settings/config-dev-kit-settings)<br />[Configuration des bacs à sable pour le développement XBOX Live](/fr/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes)<br />[XSystemGetConsoleId](/fr/reference/system/xsystem/functions/xsystemgetconsoleid)<br />[XSystem](/fr/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystemGetXboxLiveSandboxId](/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)
- [Advanced XBOX services sandboxes](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [XSystem](/reference/system/xsystem/xsystem_members.md)
- [Determining console location](/build/game-principles/localization/determining-console-geolocation.md)
- [콘솔 위치 확인](/ko/build/game-principles/localization/determining-console-geolocation.md)