> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # XUser > XUser # XUser Documentation de référence des API XUser. ## Fonctions | Fonction | Description | | - | - | | [XUserAddAsync](/fr/reference/system/xuser/functions/xuseraddasync) | Ajoute de manière asynchrone un utilisateur à une session de jeu. | | [XUserAddByIdWithUiAsync](/fr/reference/system/xuser/functions/xuseraddbyidwithuiasync) | Ajoute de manière asynchrone un utilisateur à une session de jeu à partir d'un XUID provenant d'une invitation de jeu. Cette fonction ne doit être utilisée qu'en réponse à une invitation de jeu. | | [XUserAddByIdWithUiResult](/fr/reference/system/xuser/functions/xuseraddbyidwithuiresult) | Récupère un handle vers l'utilisateur créé par XUserAddByIdWithUiAsync. Cette fonction ne doit être utilisée qu'en réponse à une invitation de jeu. | | [XUserAddResult](/fr/reference/system/xuser/functions/xuseraddresult) | Récupère un handle vers un utilisateur créé par XUserAddAsync. | | [XUserChangeEventCallback](/fr/reference/system/xuser/functions/xuserchangeeventcallback) | Rappel défini par une application pour un événement de modification d'utilisateur. | | [XUserCheckPrivilege](/fr/reference/system/xuser/functions/xusercheckprivilege) | Détermine si un utilisateur dispose d'un privilège spécifique. | | [XUserCloseHandle](/fr/reference/system/xuser/functions/xuserclosehandle) | Ferme un handle d'utilisateur spécifique. | | [XUserCloseSignOutDeferralHandle](/fr/reference/system/xuser/functions/xuserclosesignoutdeferralhandle) | Ferme un handle de report de déconnexion d'utilisateur spécifique. | | [XUserCompare](/fr/reference/system/xuser/functions/xusercompare) | Compare l'égalité de deux handles d'utilisateur. | | [XUserDefaultAudioEndpointUtf16ChangedCallback](/fr/reference/system/xuser/functions/xuserdefaultaudioendpointutf16changedcallback) | Rappel défini et invoqué par une application lorsque le point de terminaison audio par défaut d'un utilisateur change. | | [XUserDeviceAssociationChangedCallback](/fr/reference/system/xuser/functions/xuserdeviceassociationchangedcallback) | Rappel invoqué lorsque l'association entre utilisateur et appareil change. | | [XUserDuplicateHandle](/fr/reference/system/xuser/functions/xuserduplicatehandle) | Duplique un handle d'utilisateur. | | [XUserFindControllerForUserWithUiAsync](/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync) | Affiche une boîte de dialogue invitant l'utilisateur à allumer et identifier la manette qu'il souhaite utiliser. | | [XUserFindControllerForUserWithUiResult](/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult) | Récupère l'ID d'appareil local de l'application (APP\_LOCAL\_DEVICE\_ID) qu'un utilisateur a choisi d'utiliser. | | [XUserFindForDevice](/fr/reference/system/xuser/functions/xuserfindfordevice) | Récupère l'ID utilisateur correspondant à un ID d'appareil spécifique. | | [XUserFindUserById](/fr/reference/system/xuser/functions/xuserfinduserbyid) | Récupère l'ID utilisateur XBox (XUID) d'un utilisateur local. | | [XUserFindUserByLocalId](/fr/reference/system/xuser/functions/xuserfinduserbylocalid) | Récupère un handle vers l'utilisateur correspondant à un ID utilisateur local spécifique. | | [XUserGetAgeGroup](/fr/reference/system/xuser/functions/xusergetagegroup) | Renvoie la tranche d'âge d'un utilisateur. | | [XUserGetDefaultAudioEndpointUtf16](/fr/reference/system/xuser/functions/xusergetdefaultaudioendpointutf16) | Récupère le point de terminaison audio par défaut d'un utilisateur spécifique. | | [XUserGetGamerPictureAsync](/fr/reference/system/xuser/functions/xusergetgamerpictureasync) | Récupère de manière asynchrone l'image de joueur d'un utilisateur spécifique. | | [XUserGetGamerPictureResult](/fr/reference/system/xuser/functions/xusergetgamerpictureresult) | Récupère le résultat d'un appel à XUserGetGamerPictureAsync. | | [XUserGetGamerPictureResultSize](/fr/reference/system/xuser/functions/xusergetgamerpictureresultsize) | Renvoie la taille de mémoire tampon requise par [XUserGetGamerPictureResult](/fr/reference/system/xuser/functions/xusergetgamerpictureresult) pour récupérer l'image de joueur renvoyée par [XUserGetGamerPictureAsync](/fr/reference/system/xuser/functions/xusergetgamerpictureasync). | | [XUserGetGamertag](/fr/reference/system/xuser/functions/xusergetgamertag) | Récupère le gamertag d'un utilisateur spécifique. | | [XUserGetId](/fr/reference/system/xuser/functions/xusergetid) | Obtient l'ID utilisateur d'un utilisateur spécifique. | | [XUserGetIsGuest](/fr/reference/system/xuser/functions/xusergetisguest) | Renvoie un booléen indiquant si un utilisateur est un invité. | | [XUserGetLocalId](/fr/reference/system/xuser/functions/xusergetlocalid) | Récupère un ID unique de session de jeu pour un utilisateur. | | [XUserGetMaxUsers](/fr/reference/system/xuser/functions/xusergetmaxusers) | Récupère le nombre maximal d'utilisateurs autorisés par une session de jeu sur la plateforme actuelle. | | [XUserGetMsaTokenSilentlyAsync](/fr/reference/system/xuser/functions/xusergetmsatokensilentlyasync) | Cette fonction est désormais dépréciée. | | [XUserGetMsaTokenSilentlyResult](/fr/reference/system/xuser/functions/xusergetmsatokensilentlyresult) | Cette fonction est désormais dépréciée. | | [XUserGetMsaTokenSilentlyResultSize](/fr/reference/system/xuser/functions/xusergetmsatokensilentlyresultsize) | Cette fonction est désormais dépréciée. | | [XUserGetSignOutDeferral](/fr/reference/system/xuser/functions/xusergetsignoutdeferral) | Récupère un handle vers le report de déconnexion. | | [XUserGetState](/fr/reference/system/xuser/functions/xusergetstate) | Récupère l'état d'un utilisateur. | | [XUserGetTokenAndSignatureAsync](/fr/reference/system/xuser/functions/xusergettokenandsignatureasync) | Récupère de manière asynchrone des xtokens et des signatures pour les requêtes web. | | [XUserGetTokenAndSignatureResult](/fr/reference/system/xuser/functions/xusergettokenandsignatureresult) | Obtient le résultat d'un appel à XUserGetTokenAndSignatureAsync. | | [XUserGetTokenAndSignatureResultSize](/fr/reference/system/xuser/functions/xusergettokenandsignatureresultsize) | Obtient la taille de la mémoire tampon destinée à contenir les résultats d'un appel à XUserGetTokenAndSignatureAsync. | | [XUserGetTokenAndSignatureUtf16Async](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16async) | Récupère de manière asynchrone des xtokens et des signatures Unicode pour les requêtes web. | | [XUserGetTokenAndSignatureUtf16Result](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16result) | Obtient le résultat d'un appel à XUserGetTokenAndSignatureUtf16Async. | | [XUserGetTokenAndSignatureUtf16ResultSize](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize) | Obtient la taille de la mémoire tampon destinée à contenir les résultats d'un appel à XUserGetTokenAndSignatureUtf16Async. | | [XUserIsStoreUser](/fr/reference/system/xuser/functions/xuserisstoreuser) | Vérifie si le MSA de XUser est le même que le MSA connecté au Microsoft Store. | | [XUserRegisterForChangeEvent](/fr/reference/system/xuser/functions/xuserregisterforchangeevent) | Inscrit un rappel pour un événement de modification d'utilisateur. | | [XUserRegisterForDefaultAudioEndpointUtf16Changed](/fr/reference/system/xuser/functions/xuserregisterfordefaultaudioendpointutf16changed) | Inscrit un rappel défini et invoqué par l'application lorsque le point de terminaison audio par défaut change. | | [XUserRegisterForDeviceAssociationChanged](/fr/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged) | Inscrit un rappel pour les événements de modification de l'association entre utilisateur et appareil. | | [XUserResolveIssueWithUiAsync](/fr/reference/system/xuser/functions/xuserresolveissuewithuiasync) | Affiche une interface utilisateur système permettant de résoudre les problèmes de jeton avec une URL non Unicode. | | [XUserResolveIssueWithUiResult](/fr/reference/system/xuser/functions/xuserresolveissuewithuiresult) | Récupère le résultat d'un appel à XUserResolveIssueWithUiAsync. | | [XUserResolveIssueWithUiUtf16Async](/fr/reference/system/xuser/functions/xuserresolveissuewithuiutf16async) | Affiche une interface utilisateur système permettant de résoudre les problèmes de jeton avec une URL Unicode spécifique. | | [XUserResolveIssueWithUiUtf16Result](/fr/reference/system/xuser/functions/xuserresolveissuewithuiutf16result) | Récupère le résultat d'un appel à XUserResolveIssueWithUiUtf16Async. | | [XUserResolvePrivilegeWithUiAsync](/fr/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) | Affiche une interface utilisateur de résolution pour les privilèges utilisateur requis. | | [XUserResolvePrivilegeWithUiResult](/fr/reference/system/xuser/functions/xuserresolveprivilegewithuiresult) | Récupère le résultat d'un appel à XUserResolvePrivilegeWithUiAsync. | | [XUserUnregisterForChangeEvent](/fr/reference/system/xuser/functions/xuserunregisterforchangeevent) | Désinscrit un rappel de modification d'utilisateur précédemment inscrit. | | [XUserUnregisterForDefaultAudioEndpointUtf16Changed](/fr/reference/system/xuser/functions/xuserunregisterfordefaultaudioendpointutf16changed) | Désinscrit un rappel de modification du point de terminaison audio par défaut précédemment inscrit. | | [XUserUnregisterForDeviceAssociationChanged](/fr/reference/system/xuser/functions/xuserunregisterfordeviceassociationchanged) | Désinscrit un rappel de modification de l'association entre utilisateur et appareil précédemment inscrit. | | [xUserPlatformRemoteConnectSetEventHandlers](/fr/reference/system/xuser/functions/xuserplatformremoteconnectseteventhandlers) | Définit les gestionnaires d'événements de connexion à distance | | [XUserPlatformRemoteConnectCancelPrompt](/fr/reference/system/xuser/functions/xuserplatformremoteconnectcancelprompt) | Signale à XUser que l'invite de connexion à distance a été fermée par l'utilisateur. | | [XUserPlatformRemoteConnectShowPromptEventHandler](/fr/reference/system/xuser/functions/xuserplatformremoteconnectshowprompteventhandler) | Gestionnaire d'événements d'affichage de l'invite d'authentification de connexion à distance. | | [XUserPlatformRemoteConnectClosePromptEventHandler](/fr/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler) | Gestionnaire d'événements de fermeture de l'invite d'authentification à distance. | | [XUserPlatformSpopPromptEventHandler](/fr/reference/system/xuser/functions/xuserplatformspopprompteventhandler) | Gestionnaire d'événements d'affichage de l'invite pour l'opération SPOP | | [XUserPlatformSpopPromptSetEventHandlers](/fr/reference/system/xuser/functions/xuserplatformspoppromptseteventhandlers) | Définit le gestionnaire d'événements de l'invite SPOP. | | [XUserPlatformSpopPromptClearEventHandler](/fr/reference/system/xuser/functions/xuserplatformspoppromptcleareventhandler) | Efface le gestionnaire d'événements de l'invite SPOP dans XUser. | | [XUserPlatformSpopPromptComplete](/fr/reference/system/xuser/functions/xuserplatformspoppromptcomplete) | Signale à XUser que l'utilisateur a terminé d'interagir avec l'invite SPOP. | ## Structures | Structure | Description | | - | - | | [APP\_LOCAL\_DEVICE\_ID](/fr/reference/system/xuser/structs/app_local_device_id) | Spécifie l'ID racine d'un périphérique d'entrée local. | | [XUserDeviceAssociationChange](/fr/reference/system/xuser/structs/xuserdeviceassociationchange) | Spécifie l'ancienne et la nouvelle association d'appareil lorsqu'une association d'appareil change. | | [XUserGetTokenAndSignatureData](/fr/reference/system/xuser/structs/xusergettokenandsignaturedata) | Spécifie les xtokens et les signatures récupérés pour les requêtes web. | | [XUserGetTokenAndSignatureHttpHeader](/fr/reference/system/xuser/structs/xusergettokenandsignaturehttpheader) | Spécifie l'en-tête HTTP d'une requête web. | | [XUserGetTokenAndSignatureUtf16Data](/fr/reference/system/xuser/structs/xusergettokenandsignatureutf16data) | Contient des xtokens et des signatures Unicode pour les requêtes web. | | [XUserGetTokenAndSignatureUtf16HttpHeader](/fr/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader) | Contient un en-tête HTTP Unicode pour une requête web. | | [XUserLocalId](/fr/reference/system/xuser/structs/xuserlocalid) | Spécifie un ID de session de jeu pour un utilisateur. | | [XUserPlatformRemoteConnectEventHandlers](/fr/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers) | Encapsule les gestionnaires d'événements de connexion à distance | ## Énumérations | Énumération | Description | | - | - | | [XUserAddOptions](/fr/reference/system/xuser/enums/xuseraddoptions) | Spécifie les options d'ajout d'un utilisateur. | | [XUserAgeGroup](/fr/reference/system/xuser/enums/xuseragegroup) | Spécifie la tranche d'âge d'un utilisateur. | | [XUserChangeEvent](/fr/reference/system/xuser/enums/xuserchangeevent) | Spécifie le type d'événement de modification d'utilisateur. | | [XUserDefaultAudioEndpointKind](/fr/reference/system/xuser/enums/xuserdefaultaudioendpointkind) | Spécifie si le point de terminaison audio par défaut de l'utilisateur restitue ou capture l'audio. | | [XUserGamerPictureSize](/fr/reference/system/xuser/enums/xusergamerpicturesize) | Spécifie la taille de l'image de joueur en pixels. | | [XUserGamertagComponent](/fr/reference/system/xuser/enums/xusergamertagcomponent) | Spécifie le type (ou composant) de gamertag à récupérer. | | [XUserGetMsaTokenSilentlyOptions](/fr/reference/system/xuser/enums/xusergetmsatokensilentlyoptions) | Options pour XUserGetMsaTokenSilentlyOptions. | | [XUserGetTokenAndSignatureOptions](/fr/reference/system/xuser/enums/xusergettokenandsignatureoptions) | Options pour GetUserTokenAndSignatureAsync. | | [XUserPrivilege](/fr/reference/system/xuser/enums/xuserprivilege) | Spécifie les privilèges d'un utilisateur. | | [XUserPrivilegeDenyReason](/fr/reference/system/xuser/enums/xuserprivilegedenyreason) | Spécifie la raison pour laquelle un utilisateur n'a pas pu obtenir un privilège. | | [XUserPrivilegeOptions](/fr/reference/system/xuser/enums/xuserprivilegeoptions) | Spécifie les options de privilège utilisateur. | | [XUserState](/fr/reference/system/xuser/enums/xuserstate) | Spécifie l'état actuel de l'utilisateur. | | [XUserPlatformOperationResult](/fr/reference/system/xuser/enums/XUserPlatformOperationResult) | Énumération définissant les résultats d'une opération cliente | | [XUserPlatformSpopOperationResult](/fr/reference/system/xuser/enums/xuserplatformspopoperationresult) | Énumération définissant les résultats d'une opération cliente. | ## Documentation conceptuelle * [Objectifs de conception et améliorations de la programmation asynchrone](/fr/build/core-features/common/async/async-whitepaper) * [Vue d'ensemble de WinHTTP](/fr/build/console-features/networking/web-requests/intro-winhttp) * [Requêtes web (sommaire)](/fr/build/console-features/networking/web-requests/web-requests-toc) * [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) * [Utilisation des wrappers C# pour les API GDK dans votre projet Unity](/fr/build/gdk-and-engines/unity/unity-api-wrappers) ## Voir aussi [Référence des API système](/fr/reference/system/gc-reference-system-toc) ## Codes d'erreur Les codes d'erreur suivants peuvent être renvoyés par les API XUser. Pour obtenir la liste complète, consultez [Codes d'erreur](/fr/reference/errorcodes). | Code | Valeur | Description | | - | - | - | | E\_GAMEUSER\_MAX\_USERS\_ADDED | 0x89245100 | Impossible d'ajouter cet utilisateur, car le nombre maximal d'utilisateurs a été atteint. | | E\_GAMEUSER\_SIGNED\_OUT | 0x89245101 | Impossible d'effectuer l'opération, car l'utilisateur est déconnecté. | | E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | 0x89245102 | Une IU est nécessaire pour résoudre un problème lié à cet utilisateur. | | E\_GAMEUSER\_DEFERRAL\_NOT\_AVAILABLE | 0x89245103 | Le moment n'est pas approprié pour demander un report. | | E\_GAMEUSER\_USER\_NOT\_FOUND | 0x89245104 | Aucun utilisateur correspondant à l'ID n'a été trouvé. | | E\_GAMEUSER\_NO\_TOKEN\_REQUIRED | 0x89245105 | Aucun jeton n'est requis pour cet appel. | | E\_GAMEUSER\_NO\_DEFAULT\_USER | 0x89245106 | Aucun utilisateur par défaut actuel. Si vous obtenez cette erreur, appelez à nouveau XUserAddAsync sans AddDefaultUserSilently. | | E\_GAMEUSER\_FAILED\_TO\_RESOLVE | 0x89245107 | Échec de la résolution du privilège donné. | | E\_GAMEUSER\_NO\_TITLE\_ID | 0x89245108 | Un TitleId XBOX Live doit être configuré. | | E\_GAMEUSER\_UNKNOWN\_GAME\_IDENTITY | 0x89245109 | L'identité du jeu n'est pas reconnue. Le MSAAppId et le TitleId ne correspondent pas à ceux associés au jeu. | | E\_GAMEUSER\_NO\_PACKAGE\_IDENTITY | 0x89245110 | Une identité de package doit être configurée. | | E\_GAMEUSER\_FAILED\_TO\_GET\_TOKEN | 0x89245111 | La demande de jeton a échoué. | | E\_GAMEUSER\_INVALID\_APP\_CONFIGURATION | 0x89245112 | Le MSAAppId de la configuration du jeu n'est pas valide ou n'est pas configuré pour la pile d'authentification. | | E\_GAMEUSER\_MALFORMED\_MSAAPPID | 0x89245113 | Le MSAAppId de la configuration du jeu ne correspond pas au format attendu (chaîne de 16 caractères ou GUID). | | E\_GAMEUSER\_INCONSISTENT\_MSAAPPID\_AND\_TITLEID | 0x89245114 | Le MSAAppId et le TitleId de la configuration du jeu ne correspondent pas à ceux associés au jeu. | ## Related topics - [XUser](/reference/system/xuser/xuser_members.md) - [User identity and XUser](/build/core-features/common/user/player-identity-xuser.md) - [Users](/build/core-features/common/user/user-toc.md) - [Headless automation of XUser](/build/core-features/common/user/users-headless-automation.md) - [User identity and XUser APIs in the GDK](/build/core-features/common/user/index.md)