XUserAddByIdWithUiAsync
Ajoute de façon asynchrone un utilisateur à une session de jeu en fonction d’un XUID provenant d’une invitation de jeu. Cette fonction doit uniquement être utilisée en réponse à une invitation de jeu.Syntaxe
Paramètres
userId _In_Type : uint64_t XUID de l’utilisateur à ajouter. Ce XUID doit être obtenu en analysant l’inviteUri reçu dans le rappel du jeu qui a été inscrit avec XGameInviteRegisterForEvent. async _Inout_
Type : XAsyncBlock* Un XAsyncBlock permettant d’interroger l’état de l’appel et de récupérer les résultats de l’appel.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.Remarques
XUserAddByIdWithUiAsync démarre une opération asynchrone pour ajouter un utilisateur au jeu. Utilisez XUserAddByIdWithUiResult pour récupérer les résultats de l’opération. Lors du traitement des invitations de jeu, il est toujours possible sur console que le XUID de la personne spécifiée dans l’invitation de jeu ne corresponde pas à la personne déjà connectée au jeu. XUserAddByIdWithUiAsync permet au jeu d’ajouter cet utilisateur à l’aide du XUID analysé à partir de l’URI d’invitation. Cette fonction tente d’ajouter l’utilisateur sans afficher d’interface utilisateur. La seule raison pour laquelle une interface utilisateur peut s’afficher est que l’utilisateur doit résoudre un problème lié à son jeton. Sur console, l’affichage d’une interface utilisateur devrait être rare. Si l’utilisateur n’est pas connecté sur l’appareil, XUserAddByIdWithUiResult retourne E_GAMEUSER_USER_NOT_FOUND. Vous devez fermer chaque handle XUserHandle que vous récupérez à partir d’une API XUsers une seule fois en appelant XUserCloseHandle. Pour recevoir des invitations de jeu, les développeurs doivent s’abonner à XGameInviteCallback en appelant XGameInviteRegisterForEvent. Lorsque ce rappel est appelé, les jeux doivent analyser l’inviteUri reçu et déterminer le XUID de l’utilisateur qui reçoit cette invitation. À ce moment, le jeu peut vouloir obtenir un XUserHandle pour la personne qui reçoit l’invitation. Le code suivant montre comment cela fonctionne.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 SeriesVoir aussi
XUserXUserCloseHandle
