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 définie sur HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER).

Remarques

Avec le TitleID et l’ID de configuration du 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 trousse 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’accéder à l’ID du bac à sable, l’ID du bac à sable prend la valeur par défaut ‘RETAIL’. Cette fonction retourne également ‘RETAIL’ si votre jeu s’exécute effectivement dans l’environnement de vente au détail.

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 de la trousse de développement (rubrique sous NDA)
Configuration des bacs à sable pour le développement XBOX Live
XSystemGetConsoleId
XSystem
Last modified on October 6, 2026