> ## 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 pour les API XUser.

## Fonctions

| Fonction | Description |
| - | - |
| [XUserAddAsync](/fr-CA/reference/system/xuser/functions/xuseraddasync) | Ajoute de façon asynchrone un utilisateur à une session de jeu. |
| [XUserAddByIdWithUiAsync](/fr-CA/reference/system/xuser/functions/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 ne doit être utilisée qu'en réponse à une invitation de jeu. |
| [XUserAddByIdWithUiResult](/fr-CA/reference/system/xuser/functions/xuseraddbyidwithuiresult) | Récupère un handle vers l'utilisateur que XUserAddByIdWithUiAsync crée. Cette fonction ne doit être utilisée qu'en réponse à une invitation de jeu. |
| [XUserAddResult](/fr-CA/reference/system/xuser/functions/xuseraddresult) | Récupère un handle vers un utilisateur que XUserAddAsync crée. |
| [XUserChangeEventCallback](/fr-CA/reference/system/xuser/functions/xuserchangeeventcallback) | Un rappel qu'une application définit pour un événement de modification d'utilisateur. |
| [XUserCheckPrivilege](/fr-CA/reference/system/xuser/functions/xusercheckprivilege) | Détermine si un utilisateur possède un privilège spécifique. |
| [XUserCloseHandle](/fr-CA/reference/system/xuser/functions/xuserclosehandle) | Ferme un handle d'utilisateur spécifique. |
| [XUserCloseSignOutDeferralHandle](/fr-CA/reference/system/xuser/functions/xuserclosesignoutdeferralhandle) | Ferme un handle de report de déconnexion d'utilisateur spécifique. |
| [XUserCompare](/fr-CA/reference/system/xuser/functions/xusercompare) | Compare deux handles d'utilisateur pour déterminer leur égalité. |
| [XUserDefaultAudioEndpointUtf16ChangedCallback](/fr-CA/reference/system/xuser/functions/xuserdefaultaudioendpointutf16changedcallback) | Un rappel qu'une application définit et appelle lorsque le point de terminaison audio par défaut d'un utilisateur change. |
| [XUserDeviceAssociationChangedCallback](/fr-CA/reference/system/xuser/functions/xuserdeviceassociationchangedcallback) | Un rappel qui est appelé lorsque l'association utilisateur-périphérique change. |
| [XUserDuplicateHandle](/fr-CA/reference/system/xuser/functions/xuserduplicatehandle) | Duplique un handle d'utilisateur. |
| [XUserFindControllerForUserWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync) | Affiche une boîte de dialogue qui invite l'utilisateur à allumer et à identifier la manette qu'il souhaite utiliser. |
| [XUserFindControllerForUserWithUiResult](/fr-CA/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult) | Récupère l'ID de périphérique local de l'application (APP\_LOCAL\_DEVICE\_ID) qu'un utilisateur a choisi d'utiliser. |
| [XUserFindForDevice](/fr-CA/reference/system/xuser/functions/xuserfindfordevice) | Récupère l'ID d'utilisateur pour un ID de périphérique spécifique. |
| [XUserFindUserById](/fr-CA/reference/system/xuser/functions/xuserfinduserbyid) | Récupère l'ID d'utilisateur XBox (XUID) d'un utilisateur local. |
| [XUserFindUserByLocalId](/fr-CA/reference/system/xuser/functions/xuserfinduserbylocalid) | Récupère un handle vers l'utilisateur pour un ID d'utilisateur local spécifique. |
| [XUserGetAgeGroup](/fr-CA/reference/system/xuser/functions/xusergetagegroup) | Retourne le groupe d'âge d'un utilisateur. |
| [XUserGetDefaultAudioEndpointUtf16](/fr-CA/reference/system/xuser/functions/xusergetdefaultaudioendpointutf16) | Récupère le point de terminaison audio par défaut d'un utilisateur spécifique. |
| [XUserGetGamerPictureAsync](/fr-CA/reference/system/xuser/functions/xusergetgamerpictureasync) | Récupère de façon asynchrone l'image du joueur d'un utilisateur spécifique. |
| [XUserGetGamerPictureResult](/fr-CA/reference/system/xuser/functions/xusergetgamerpictureresult) | Récupère le résultat d'un appel à XUserGetGamerPictureAsync. |
| [XUserGetGamerPictureResultSize](/fr-CA/reference/system/xuser/functions/xusergetgamerpictureresultsize) | Retourne la taille de mémoire tampon dont [XUserGetGamerPictureResult](/fr-CA/reference/system/xuser/functions/xusergetgamerpictureresult) a besoin pour récupérer l'image du joueur que [XUserGetGamerPictureAsync](/fr-CA/reference/system/xuser/functions/xusergetgamerpictureasync) retourne. |
| [XUserGetGamertag](/fr-CA/reference/system/xuser/functions/xusergetgamertag) | Récupère le gamertag d'un utilisateur spécifique. |
| [XUserGetId](/fr-CA/reference/system/xuser/functions/xusergetid) | Obtient l'ID d'utilisateur d'un utilisateur spécifique. |
| [XUserGetIsGuest](/fr-CA/reference/system/xuser/functions/xusergetisguest) | Retourne une valeur booléenne qui indique si un utilisateur est un invité. |
| [XUserGetLocalId](/fr-CA/reference/system/xuser/functions/xusergetlocalid) | Récupère un ID de session de jeu unique pour un utilisateur. |
| [XUserGetMaxUsers](/fr-CA/reference/system/xuser/functions/xusergetmaxusers) | Récupère le nombre maximal d'utilisateurs qu'une session de jeu autorise sur la plateforme actuelle. |
| [XUserGetMsaTokenSilentlyAsync](/fr-CA/reference/system/xuser/functions/xusergetmsatokensilentlyasync) | Cette fonction est maintenant dépréciée. |
| [XUserGetMsaTokenSilentlyResult](/fr-CA/reference/system/xuser/functions/xusergetmsatokensilentlyresult) | Cette fonction est maintenant dépréciée. |
| [XUserGetMsaTokenSilentlyResultSize](/fr-CA/reference/system/xuser/functions/xusergetmsatokensilentlyresultsize) | Cette fonction est maintenant dépréciée. |
| [XUserGetSignOutDeferral](/fr-CA/reference/system/xuser/functions/xusergetsignoutdeferral) | Récupère un handle vers le report de déconnexion. |
| [XUserGetState](/fr-CA/reference/system/xuser/functions/xusergetstate) | Récupère l'état d'un utilisateur. |
| [XUserGetTokenAndSignatureAsync](/fr-CA/reference/system/xuser/functions/xusergettokenandsignatureasync) | Récupère de façon asynchrone des xtokens et des signatures pour les requêtes web. |
| [XUserGetTokenAndSignatureResult](/fr-CA/reference/system/xuser/functions/xusergettokenandsignatureresult) | Obtient le résultat d'un appel à XUserGetTokenAndSignatureAsync. |
| [XUserGetTokenAndSignatureResultSize](/fr-CA/reference/system/xuser/functions/xusergettokenandsignatureresultsize) | Obtient la taille de la mémoire tampon nécessaire pour contenir les résultats d'un appel à XUserGetTokenAndSignatureAsync. |
| [XUserGetTokenAndSignatureUtf16Async](/fr-CA/reference/system/xuser/functions/xusergettokenandsignatureutf16async) | Récupère de façon asynchrone des xtokens et des signatures Unicode pour les requêtes web. |
| [XUserGetTokenAndSignatureUtf16Result](/fr-CA/reference/system/xuser/functions/xusergettokenandsignatureutf16result) | Obtient le résultat d'un appel à XUserGetTokenAndSignatureUtf16Async. |
| [XUserGetTokenAndSignatureUtf16ResultSize](/fr-CA/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize) | Obtient la taille de la mémoire tampon nécessaire pour contenir les résultats d'un appel à XUserGetTokenAndSignatureUtf16Async. |
| [XUserIsStoreUser](/fr-CA/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-CA/reference/system/xuser/functions/xuserregisterforchangeevent) | Inscrit un rappel pour un événement de modification d'utilisateur. |
| [XUserRegisterForDefaultAudioEndpointUtf16Changed](/fr-CA/reference/system/xuser/functions/xuserregisterfordefaultaudioendpointutf16changed) | Inscrit un rappel que l'application définit et appelle lorsque le point de terminaison audio par défaut change. |
| [XUserRegisterForDeviceAssociationChanged](/fr-CA/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged) | Inscrit un rappel pour les événements de modification de l'association entre l'utilisateur et le périphérique. |
| [XUserResolveIssueWithUiAsync](/fr-CA/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-CA/reference/system/xuser/functions/xuserresolveissuewithuiresult) | Récupère le résultat d'un appel à XUserResolveIssueWithUiAsync. |
| [XUserResolveIssueWithUiUtf16Async](/fr-CA/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-CA/reference/system/xuser/functions/xuserresolveissuewithuiutf16result) | Récupère le résultat d'un appel à XUserResolveIssueWithUiUtf16Async. |
| [XUserResolvePrivilegeWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) | Affiche une interface utilisateur de résolution pour les privilèges utilisateur requis. |
| [XUserResolvePrivilegeWithUiResult](/fr-CA/reference/system/xuser/functions/xuserresolveprivilegewithuiresult) | Récupère le résultat d'un appel à XUserResolvePrivilegeWithUiAsync. |
| [XUserUnregisterForChangeEvent](/fr-CA/reference/system/xuser/functions/xuserunregisterforchangeevent) | Annule l'inscription d'un rappel de modification d'utilisateur inscrit précédemment. |
| [XUserUnregisterForDefaultAudioEndpointUtf16Changed](/fr-CA/reference/system/xuser/functions/xuserunregisterfordefaultaudioendpointutf16changed) | Annule l'inscription d'un rappel de modification du point de terminaison audio par défaut inscrit précédemment. |
| [XUserUnregisterForDeviceAssociationChanged](/fr-CA/reference/system/xuser/functions/xuserunregisterfordeviceassociationchanged) | Annule l'inscription d'un rappel de modification de l'association entre l'utilisateur et le périphérique inscrit précédemment. |
| [xUserPlatformRemoteConnectSetEventHandlers](/fr-CA/reference/system/xuser/functions/xuserplatformremoteconnectseteventhandlers) | Définit les gestionnaires d'événements de connexion à distance |
| [XUserPlatformRemoteConnectCancelPrompt](/fr-CA/reference/system/xuser/functions/xuserplatformremoteconnectcancelprompt) | Signale à XUser que l'invite de connexion à distance a été fermée par l'utilisateur. |
| [XUserPlatformRemoteConnectShowPromptEventHandler](/fr-CA/reference/system/xuser/functions/xuserplatformremoteconnectshowprompteventhandler) | Gestionnaire d'événements d'affichage de l'invite pour l'authentification par connexion à distance. |
| [XUserPlatformRemoteConnectClosePromptEventHandler](/fr-CA/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler) | Gestionnaire d'événements de fermeture de l'invite pour l'authentification à distance. |
| [XUserPlatformSpopPromptEventHandler](/fr-CA/reference/system/xuser/functions/xuserplatformspopprompteventhandler) | Gestionnaire d'événements d'affichage de l'invite pour une opération SPOP |
| [XUserPlatformSpopPromptSetEventHandlers](/fr-CA/reference/system/xuser/functions/xuserplatformspoppromptseteventhandlers) | Définit le gestionnaire d'événements de l'invite SPOP. |
| [XUserPlatformSpopPromptClearEventHandler](/fr-CA/reference/system/xuser/functions/xuserplatformspoppromptcleareventhandler) | Efface le gestionnaire d'événements de l'invite SPOP dans XUser. |
| [XUserPlatformSpopPromptComplete](/fr-CA/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-CA/reference/system/xuser/structs/app_local_device_id) | Spécifie l'ID racine d'un périphérique d'entrée local. |
| [XUserDeviceAssociationChange](/fr-CA/reference/system/xuser/structs/xuserdeviceassociationchange) | Spécifie l'ancienne et la nouvelle association de périphérique lorsqu'une association de périphérique change. |
| [XUserGetTokenAndSignatureData](/fr-CA/reference/system/xuser/structs/xusergettokenandsignaturedata) | Spécifie les xtokens et les signatures que nous récupérons pour les requêtes web. |
| [XUserGetTokenAndSignatureHttpHeader](/fr-CA/reference/system/xuser/structs/xusergettokenandsignaturehttpheader) | Spécifie l'en-tête HTTP d'une requête web. |
| [XUserGetTokenAndSignatureUtf16Data](/fr-CA/reference/system/xuser/structs/xusergettokenandsignatureutf16data) | Contient des xtokens et des signatures Unicode pour les requêtes web. |
| [XUserGetTokenAndSignatureUtf16HttpHeader](/fr-CA/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader) | Contient un en-tête HTTP Unicode pour une requête web. |
| [XUserLocalId](/fr-CA/reference/system/xuser/structs/xuserlocalid) | Spécifie un ID de session de jeu pour un utilisateur. |
| [XUserPlatformRemoteConnectEventHandlers](/fr-CA/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers) | Encapsule les gestionnaires d'événements de connexion à distance |

## Énumérations

| Énumération | Description |
| - | - |
| [XUserAddOptions](/fr-CA/reference/system/xuser/enums/xuseraddoptions) | Spécifie les options d'ajout d'un utilisateur. |
| [XUserAgeGroup](/fr-CA/reference/system/xuser/enums/xuseragegroup) | Spécifie le groupe d'âge d'un utilisateur. |
| [XUserChangeEvent](/fr-CA/reference/system/xuser/enums/xuserchangeevent) | Spécifie le type d'événement de modification d'utilisateur. |
| [XUserDefaultAudioEndpointKind](/fr-CA/reference/system/xuser/enums/xuserdefaultaudioendpointkind) | Spécifie si le point de terminaison audio par défaut de l'utilisateur effectue le rendu ou la capture audio. |
| [XUserGamerPictureSize](/fr-CA/reference/system/xuser/enums/xusergamerpicturesize) | Spécifie la taille de l'image du joueur en pixels. |
| [XUserGamertagComponent](/fr-CA/reference/system/xuser/enums/xusergamertagcomponent) | Spécifie le type (ou composant) de gamertag à extraire. |
| [XUserGetMsaTokenSilentlyOptions](/fr-CA/reference/system/xuser/enums/xusergetmsatokensilentlyoptions) | Options pour XUserGetMsaTokenSilentlyOptions. |
| [XUserGetTokenAndSignatureOptions](/fr-CA/reference/system/xuser/enums/xusergettokenandsignatureoptions) | Options pour GetUserTokenAndSignatureAsync. |
| [XUserPrivilege](/fr-CA/reference/system/xuser/enums/xuserprivilege) | Spécifie les privilèges d'un utilisateur. |
| [XUserPrivilegeDenyReason](/fr-CA/reference/system/xuser/enums/xuserprivilegedenyreason) | Spécifie la raison pour laquelle un utilisateur n'a pas pu obtenir un privilège. |
| [XUserPrivilegeOptions](/fr-CA/reference/system/xuser/enums/xuserprivilegeoptions) | Spécifie les options de privilège de l'utilisateur. |
| [XUserState](/fr-CA/reference/system/xuser/enums/xuserstate) | Spécifie l'état actuel de l'utilisateur. |
| [XUserPlatformOperationResult](/fr-CA/reference/system/xuser/enums/XUserPlatformOperationResult) | Énumération définissant les résultats d'une opération cliente |
| [XUserPlatformSpopOperationResult](/fr-CA/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-CA/build/core-features/common/async/async-whitepaper)
* [Vue d'ensemble de WinHTTP](/fr-CA/build/console-features/networking/web-requests/intro-winhttp)
* [Requêtes web (sommaire)](/fr-CA/build/console-features/networking/web-requests/web-requests-toc)
* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Utilisation des wrappers C# pour les API du GDK dans votre projet Unity](/fr-CA/build/gdk-and-engines/unity/unity-api-wrappers)

## Voir aussi

[Référence des API système](/fr-CA/reference/system/gc-reference-system-toc)

## Codes d'erreur

Les codes d'erreur suivants peuvent être retournés par les API XUser. Pour obtenir la liste complète, consultez [Codes d'erreur](/fr-CA/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 requise pour résoudre un problème avec 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 de 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 dans 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 dans 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 dans 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)