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 à répétition XUserAddAsync avec options défini sur XUserAddOptions::AddDefaultUserSilently :
  • Si vous appelez cette fonction à répétition 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 définissant cet utilisateur 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 à répétition XUserAddAsync avec options défini sur XUserAddOptions::AddDefaultUserAllowingUI. Ils sont très semblables (mais pas identiques) au cas silencieux :
  • Si vous appelez cette fonction à répétition 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 de 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