Skip to main content

XUserAddOptions

Spécifie les options d’ajout d’un utilisateur.

Syntaxe

Constantes

Remarques

Il existe certains cas limites que les développeurs doivent connaître s’ils appellent de manière répétée XUserAddAsync avec options défini sur XUserAddOptions::AddDefaultUserSilently :
  • Si vous appelez cette fonction de manière répétée et que l’utilisateur par défaut qui a lancé le jeu est connu, elle retourne ce même utilisateur.
  • Si l’utilisateur par défaut précédemment connu s’est déconnecté et qu’un seul utilisateur est connecté sur l’appareil, elle marque cet utilisateur comme nouvel utilisateur « par défaut » et le retourne.
  • Si l’utilisateur par défaut précédemment connu s’est déconnecté et que plusieurs utilisateurs sont connectés sur l’appareil, elle retourne E_GAMEUSER_NO_DEFAULT_USER.
  • Lors des lancements en mode développeur, l’utilisateur par défaut est l’utilisateur à connexion automatique, que vous pouvez spécifier en le définissant comme utilisateur à connexion automatique dans DevHome ou en utilisant DefaultUser de xbconfig (rubrique sous NDA).
Si aucun utilisateur par défaut n’est disponible*, XUserAddResult retourne E_GAMEUSER_NO_DEFAULT_USER. Vous devez appeler XUserAddAsync avec options non défini sur XUserAddOptions::AddDefaultUserSilently. Il existe également certains cas limites que les développeurs doivent connaître s’ils appellent de manière répétée XUserAddAsync avec options défini sur XUserAddOptions::AddDefaultUserAllowingUI. Ils sont très semblables (mais pas identiques) au cas silencieux :
  • Si vous appelez cette fonction de manière répétée et que l’utilisateur par défaut qui a lancé le jeu est connu, elle retourne ce même utilisateur.
  • Si l’utilisateur par défaut précédemment connu s’est déconnecté et qu’un seul utilisateur est connecté sur l’appareil, elle marque cet utilisateur comme nouvel utilisateur « par défaut » et le retourne.
  • Si l’utilisateur qui a initialement lancé le jeu s’est déconnecté et que le nombre d’utilisateurs est égal à 0 ou supérieur à 1, le système affiche une interface utilisateur pour obtenir l’utilisateur, puis définit cet utilisateur comme utilisateur par défaut.
Dans XUserAddAsync, vous ne pouvez pas utiliser XUserAddOptions::AllowGuests avec XUserAddOptions::AddDefaultUserSilently. Un invité ne peut pas être l’utilisateur par défaut. Vous pouvez utiliser XUserAddOptions::AllowGuests, même si la plateforme actuelle ne prend pas en charge les invités. L’exemple suivant montre comment ajouter de façon asynchrone un utilisateur à une session de jeu.

Configuration requise

En-tête : XUser.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XUser XUserAddAsync XUserAddResult
Last modified on October 6, 2026