> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUser (contenu de l'API)

> XUser

# XUser

Documentation de référence des API XUser.

## Fonctions

| Fonction | Description |
| - | - |
| [XUserAddAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xuseraddasync.md) | Ajoute de manière asynchrone un utilisateur à une session de jeu. |
| [XUserAddByIdWithUiAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xuseraddbyidwithuiasync.md) | 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](https://docs.xbox.com/fr/reference/system/xuser/functions/xuseraddbyidwithuiresult.md) | 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](https://docs.xbox.com/fr/reference/system/xuser/functions/xuseraddresult.md) | Récupère un handle vers un utilisateur créé par XUserAddAsync. |
| [XUserChangeEventCallback](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserchangeeventcallback.md) | Rappel défini par une application pour un événement de modification d'utilisateur. |
| [XUserCheckPrivilege](https://docs.xbox.com/fr/reference/system/xuser/functions/xusercheckprivilege.md) | Détermine si un utilisateur dispose d'un privilège spécifique. |
| [XUserCloseHandle](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserclosehandle.md) | Ferme un handle d'utilisateur spécifique. |
| [XUserCloseSignOutDeferralHandle](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserclosesignoutdeferralhandle.md) | Ferme un handle de report de déconnexion d'utilisateur spécifique. |
| [XUserCompare](https://docs.xbox.com/fr/reference/system/xuser/functions/xusercompare.md) | Compare l'égalité de deux handles d'utilisateur. |
| [XUserDefaultAudioEndpointUtf16ChangedCallback](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserdefaultaudioendpointutf16changedcallback.md) | Rappel défini et invoqué par une application lorsque le point de terminaison audio par défaut d'un utilisateur change. |
| [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md) | Rappel invoqué lorsque l'association entre utilisateur et appareil change. |
| [XUserDuplicateHandle](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserduplicatehandle.md) | Duplique un handle d'utilisateur. |
| [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md) | Affiche une boîte de dialogue invitant l'utilisateur à allumer et identifier la manette qu'il souhaite utiliser. |
| [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md) | Récupère l'ID d'appareil local de l'application (APP\_LOCAL\_DEVICE\_ID) qu'un utilisateur a choisi d'utiliser. |
| [XUserFindForDevice](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfindfordevice.md) | Récupère l'ID utilisateur correspondant à un ID d'appareil spécifique. |
| [XUserFindUserById](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfinduserbyid.md) | Récupère l'ID utilisateur XBox (XUID) d'un utilisateur local. |
| [XUserFindUserByLocalId](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfinduserbylocalid.md) | Récupère un handle vers l'utilisateur correspondant à un ID utilisateur local spécifique. |
| [XUserGetAgeGroup](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetagegroup.md) | Renvoie la tranche d'âge d'un utilisateur. |
| [XUserGetDefaultAudioEndpointUtf16](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetdefaultaudioendpointutf16.md) | Récupère le point de terminaison audio par défaut d'un utilisateur spécifique. |
| [XUserGetGamerPictureAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetgamerpictureasync.md) | Récupère de manière asynchrone l'image de joueur d'un utilisateur spécifique. |
| [XUserGetGamerPictureResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetgamerpictureresult.md) | Récupère le résultat d'un appel à XUserGetGamerPictureAsync. |
| [XUserGetGamerPictureResultSize](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetgamerpictureresultsize.md) | Renvoie la taille de mémoire tampon requise par [XUserGetGamerPictureResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetgamerpictureresult.md) pour récupérer l'image de joueur renvoyée par [XUserGetGamerPictureAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetgamerpictureasync.md). |
| [XUserGetGamertag](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetgamertag.md) | Récupère le gamertag d'un utilisateur spécifique. |
| [XUserGetId](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetid.md) | Obtient l'ID utilisateur d'un utilisateur spécifique. |
| [XUserGetIsGuest](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetisguest.md) | Renvoie un booléen indiquant si un utilisateur est un invité. |
| [XUserGetLocalId](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetlocalid.md) | Récupère un ID unique de session de jeu pour un utilisateur. |
| [XUserGetMaxUsers](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetmaxusers.md) | Récupère le nombre maximal d'utilisateurs autorisés par une session de jeu sur la plateforme actuelle. |
| [XUserGetMsaTokenSilentlyAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetmsatokensilentlyasync.md) | Cette fonction est désormais dépréciée. |
| [XUserGetMsaTokenSilentlyResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetmsatokensilentlyresult.md) | Cette fonction est désormais dépréciée. |
| [XUserGetMsaTokenSilentlyResultSize](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetmsatokensilentlyresultsize.md) | Cette fonction est désormais dépréciée. |
| [XUserGetSignOutDeferral](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetsignoutdeferral.md) | Récupère un handle vers le report de déconnexion. |
| [XUserGetState](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetstate.md) | Récupère l'état d'un utilisateur. |
| [XUserGetTokenAndSignatureAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergettokenandsignatureasync.md) | Récupère de manière asynchrone des xtokens et des signatures pour les requêtes web. |
| [XUserGetTokenAndSignatureResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | Obtient le résultat d'un appel à XUserGetTokenAndSignatureAsync. |
| [XUserGetTokenAndSignatureResultSize](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergettokenandsignatureresultsize.md) | Obtient la taille de la mémoire tampon destinée à contenir les résultats d'un appel à XUserGetTokenAndSignatureAsync. |
| [XUserGetTokenAndSignatureUtf16Async](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16async.md) | Récupère de manière asynchrone des xtokens et des signatures Unicode pour les requêtes web. |
| [XUserGetTokenAndSignatureUtf16Result](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md) | Obtient le résultat d'un appel à XUserGetTokenAndSignatureUtf16Async. |
| [XUserGetTokenAndSignatureUtf16ResultSize](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md) | Obtient la taille de la mémoire tampon destinée à contenir les résultats d'un appel à XUserGetTokenAndSignatureUtf16Async. |
| [XUserIsStoreUser](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserisstoreuser.md) | Vérifie si le MSA de XUser est le même que le MSA connecté au Microsoft Store. |
| [XUserRegisterForChangeEvent](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserregisterforchangeevent.md) | Inscrit un rappel pour un événement de modification d'utilisateur. |
| [XUserRegisterForDefaultAudioEndpointUtf16Changed](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserregisterfordefaultaudioendpointutf16changed.md) | Inscrit un rappel défini et invoqué par l'application lorsque le point de terminaison audio par défaut change. |
| [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md) | Inscrit un rappel pour les événements de modification de l'association entre utilisateur et appareil. |
| [XUserResolveIssueWithUiAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserresolveissuewithuiasync.md) | Affiche une interface utilisateur système permettant de résoudre les problèmes de jeton avec une URL non Unicode. |
| [XUserResolveIssueWithUiResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserresolveissuewithuiresult.md) | Récupère le résultat d'un appel à XUserResolveIssueWithUiAsync. |
| [XUserResolveIssueWithUiUtf16Async](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserresolveissuewithuiutf16async.md) | Affiche une interface utilisateur système permettant de résoudre les problèmes de jeton avec une URL Unicode spécifique. |
| [XUserResolveIssueWithUiUtf16Result](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserresolveissuewithuiutf16result.md) | Récupère le résultat d'un appel à XUserResolveIssueWithUiUtf16Async. |
| [XUserResolvePrivilegeWithUiAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserresolveprivilegewithuiasync.md) | Affiche une interface utilisateur de résolution pour les privilèges utilisateur requis. |
| [XUserResolvePrivilegeWithUiResult](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserresolveprivilegewithuiresult.md) | Récupère le résultat d'un appel à XUserResolvePrivilegeWithUiAsync. |
| [XUserUnregisterForChangeEvent](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserunregisterforchangeevent.md) | Désinscrit un rappel de modification d'utilisateur précédemment inscrit. |
| [XUserUnregisterForDefaultAudioEndpointUtf16Changed](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserunregisterfordefaultaudioendpointutf16changed.md) | Désinscrit un rappel de modification du point de terminaison audio par défaut précédemment inscrit. |
| [XUserUnregisterForDeviceAssociationChanged](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserunregisterfordeviceassociationchanged.md) | Désinscrit un rappel de modification de l'association entre utilisateur et appareil précédemment inscrit. |
| [xUserPlatformRemoteConnectSetEventHandlers](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformremoteconnectseteventhandlers.md) | Définit les gestionnaires d'événements de connexion à distance |
| [XUserPlatformRemoteConnectCancelPrompt](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformremoteconnectcancelprompt.md) | Signale à XUser que l'invite de connexion à distance a été fermée par l'utilisateur. |
| [XUserPlatformRemoteConnectShowPromptEventHandler](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformremoteconnectshowprompteventhandler.md) | Gestionnaire d'événements d'affichage de l'invite d'authentification de connexion à distance. |
| [XUserPlatformRemoteConnectClosePromptEventHandler](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler.md) | Gestionnaire d'événements de fermeture de l'invite d'authentification à distance. |
| [XUserPlatformSpopPromptEventHandler](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformspopprompteventhandler.md) | Gestionnaire d'événements d'affichage de l'invite pour l'opération SPOP |
| [XUserPlatformSpopPromptSetEventHandlers](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformspoppromptseteventhandlers.md) | Définit le gestionnaire d'événements de l'invite SPOP. |
| [XUserPlatformSpopPromptClearEventHandler](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformspoppromptcleareventhandler) | Efface le gestionnaire d'événements de l'invite SPOP dans XUser. |
| [XUserPlatformSpopPromptComplete](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserplatformspoppromptcomplete.md) | Signale à XUser que l'utilisateur a terminé d'interagir avec l'invite SPOP. |

## Structures

| Structure | Description |
| - | - |
| [APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/fr/reference/system/xuser/structs/app_local_device_id.md) | Spécifie l'ID racine d'un périphérique d'entrée local. |
| [XUserDeviceAssociationChange](https://docs.xbox.com/fr/reference/system/xuser/structs/xuserdeviceassociationchange.md) | Spécifie l'ancienne et la nouvelle association d'appareil lorsqu'une association d'appareil change. |
| [XUserGetTokenAndSignatureData](https://docs.xbox.com/fr/reference/system/xuser/structs/xusergettokenandsignaturedata.md) | Spécifie les xtokens et les signatures récupérés pour les requêtes web. |
| [XUserGetTokenAndSignatureHttpHeader](https://docs.xbox.com/fr/reference/system/xuser/structs/xusergettokenandsignaturehttpheader.md) | Spécifie l'en-tête HTTP d'une requête web. |
| [XUserGetTokenAndSignatureUtf16Data](https://docs.xbox.com/fr/reference/system/xuser/structs/xusergettokenandsignatureutf16data.md) | Contient des xtokens et des signatures Unicode pour les requêtes web. |
| [XUserGetTokenAndSignatureUtf16HttpHeader](https://docs.xbox.com/fr/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader.md) | Contient un en-tête HTTP Unicode pour une requête web. |
| [XUserLocalId](https://docs.xbox.com/fr/reference/system/xuser/structs/xuserlocalid.md) | Spécifie un ID de session de jeu pour un utilisateur. |
| [XUserPlatformRemoteConnectEventHandlers](https://docs.xbox.com/fr/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers.md) | Encapsule les gestionnaires d'événements de connexion à distance |

## Énumérations

| Énumération | Description |
| - | - |
| [XUserAddOptions](https://docs.xbox.com/fr/reference/system/xuser/enums/xuseraddoptions.md) | Spécifie les options d'ajout d'un utilisateur. |
| [XUserAgeGroup](https://docs.xbox.com/fr/reference/system/xuser/enums/xuseragegroup.md) | Spécifie la tranche d'âge d'un utilisateur. |
| [XUserChangeEvent](https://docs.xbox.com/fr/reference/system/xuser/enums/xuserchangeevent.md) | Spécifie le type d'événement de modification d'utilisateur. |
| [XUserDefaultAudioEndpointKind](https://docs.xbox.com/fr/reference/system/xuser/enums/xuserdefaultaudioendpointkind.md) | Spécifie si le point de terminaison audio par défaut de l'utilisateur restitue ou capture l'audio. |
| [XUserGamerPictureSize](https://docs.xbox.com/fr/reference/system/xuser/enums/xusergamerpicturesize.md) | Spécifie la taille de l'image de joueur en pixels. |
| [XUserGamertagComponent](https://docs.xbox.com/fr/reference/system/xuser/enums/xusergamertagcomponent.md) | Spécifie le type (ou composant) de gamertag à récupérer. |
| [XUserGetMsaTokenSilentlyOptions](https://docs.xbox.com/fr/reference/system/xuser/enums/xusergetmsatokensilentlyoptions.md) | Options pour XUserGetMsaTokenSilentlyOptions. |
| [XUserGetTokenAndSignatureOptions](https://docs.xbox.com/fr/reference/system/xuser/enums/xusergettokenandsignatureoptions.md) | Options pour GetUserTokenAndSignatureAsync. |
| [XUserPrivilege](https://docs.xbox.com/fr/reference/system/xuser/enums/xuserprivilege.md) | Spécifie les privilèges d'un utilisateur. |
| [XUserPrivilegeDenyReason](https://docs.xbox.com/fr/reference/system/xuser/enums/xuserprivilegedenyreason.md) | Spécifie la raison pour laquelle un utilisateur n'a pas pu obtenir un privilège. |
| [XUserPrivilegeOptions](https://docs.xbox.com/fr/reference/system/xuser/enums/xuserprivilegeoptions.md) | Spécifie les options de privilège utilisateur. |
| [XUserState](https://docs.xbox.com/fr/reference/system/xuser/enums/xuserstate.md) | Spécifie l'état actuel de l'utilisateur. |
| [XUserPlatformOperationResult](https://docs.xbox.com/fr/reference/system/xuser/enums/XUserPlatformOperationResult.md) | Énumération définissant les résultats d'une opération cliente |
| [XUserPlatformSpopOperationResult](https://docs.xbox.com/fr/reference/system/xuser/enums/xuserplatformspopoperationresult.md) | Énumération définissant les résultats d'une opération cliente. |

## Documentation conceptuelle

* [Objectifs de conception et améliorations de la programmation asynchrone](https://docs.xbox.com/fr/build/core-features/common/async/async-whitepaper.md)
* [Vue d'ensemble de WinHTTP](https://docs.xbox.com/fr/build/console-features/networking/web-requests/intro-winhttp.md)
* [Requêtes web (sommaire)](https://docs.xbox.com/fr/build/console-features/networking/web-requests/web-requests-toc.md)
* [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](https://docs.xbox.com/fr/build/gdk-and-engines/unity/unity-api-wrappers.md)

## Voir aussi

[Référence des API système](https://docs.xbox.com/fr/reference/system/gc-reference-system-toc.md)

## 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](https://docs.xbox.com/fr/reference/errorcodes.md).

| 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

- [XtfUser (contenu de l'API)](https://docs.xbox.com/fr/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n.md)
- [XStore (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xstore/xstore_members.md)
- [XAppCapture (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xappcapture/xappcapture_members.md)
- [XPersistentLocalStorage (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [Membres de GameChat2 (contenu de l'API)](https://docs.xbox.com/fr/reference/chat/gamechat2/gamechat2_members.md)