Skip to main content

​
XSystemGetXboxLiveSandboxId

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

​
Syntaxe

​
Paramètres

sandboxIdSize _In_
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)
Type : char* Mémoire tampon de caractères qui recevra l’ID du bac à sable. sandboxIdUsed _Out_opt_
Type : size_t* Taille réelle, en octets, de la mémoire tampon sandboxId retournée.

​
Valeur de retour

Type : HRESULT 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. 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.
Les ID de bac à sable respectent la casse.
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

​
Voir aussi

Configuration des paramètres du kit de développement (rubrique sous NDA)
Configuration des bacs à sable pour le développement XBOX Live
XSystemGetConsoleId
XSystem
Last modified on October 6, 2026