Skip to main content

XUserAddResult

Récupère un handle vers un utilisateur créé par XUserAddAsync.

Syntaxe

Paramètres

async   _Inout_
Type : XAsyncBlock*
Bloc asynchrone envoyé à XUserAddAsync. newUser   _Out_
Type : XUserHandle*
Contient un handle vers le nouvel utilisateur.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

XUserAddAsync démarre une opération asynchrone pour ajouter un utilisateur au jeu. Utilisez XUserAddResult pour récupérer les résultats de l’opération. XUserAddAsync affiche toujours une interface utilisateur de sélection de compte, sauf si vous passez XUserAddOptions::AddDefaultUserSilently au paramètre options. Si vous utilisez XUserAddOptions::AddDefaultUserSilently, XUserAddAsync n’affiche pas d’interface utilisateur. L’utilisateur retourné par XUserAddOptions::AddDefaultUserSilently continue d’être retourné jusqu’à ce que l’utilisateur se déconnecte. Si aucun utilisateur par défaut n’est disponible, XUserAddResult retourne E_GAMEUSER_NO_DEFAULT_USER. Cela indique que vous devez appeler XUserAddAsync sans XUserAddOptions::AddDefaultUserSilently pour sélectionner un utilisateur. Si un utilisateur est exclu de XBOX Live, le jeu ne pourra pas obtenir de XUserHandle pour cet utilisateur. Si XUserAddOptions::AddDefaultUserSilently est utilisé et que le jeu a été lancé par un utilisateur exclu, XUserAddResult retourne E_GAMEUSER_NO_DEFAULT_USER. Sinon, si une interface utilisateur est affichée, soit un utilisateur non exclu devra se connecter, soit l’utilisateur devra annuler l’interface utilisateur, auquel cas XUserAddResult retournera E_ABORT. 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 en toute sécurité, que la plateforme actuelle prenne en charge les invités ou non. Vous devez fermer une fois chaque handle XUserHandle que vous récupérez à partir d’une API XUsers en appelant XUserCloseHandle. L’exemple suivant montre comment ajouter de façon asynchrone un utilisateur à une session de jeu.

Configuration requise

En-tête : XUser.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XUser XUserAddAsync XUserAddOptions XUserCloseHandle
Last modified on October 6, 2026