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 SeriesDocumentation conceptuelle
- Exécuter une tâche d’API Microsoft Game Development Kit (GDK)
- Objectifs de conception et améliorations de la programmation asynchrone
