> ## 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.

# XUserFindUserById

> XUserFindUserById

# XUserFindUserById

Récupère le XUserHandle en fonction de l'ID d'utilisateur XBOX (XUID) d'un utilisateur local.

## Syntaxe

```cpp theme={null}
HRESULT XUserFindUserById(  
         uint64_t userId,  
         XUserHandle* handle  
)  
```

### Paramètres

*userId*   \_In\_\
Type : uint64\_t

Utilisateur local dont il faut récupérer le XUID.

*handle*   \_Out\_\
Type : XUserHandle\*

Contient le XUID de l'utilisateur local.

### 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](/fr-CA/reference/errorcodes).

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread sensible au temps. Pour plus d'informations, consultez [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Pour chaque handle **XUserHandle** que vous récupérez d'une API **XUser**, y compris **XUserFindUserById**, vous devez
fermer ce handle en appelant [XUserCloseHandle](/fr-CA/reference/system/xuser/functions/xuserclosehandle).

Pour récupérer l'ID d'utilisateur XBox (XUID) d'un utilisateur local, appelez XUserFindUserById.

Pour récupérer un handle d'utilisateur pour un ID d'utilisateur local donné, appelez [XUserFindUserByLocalId](/fr-CA/reference/system/xuser/functions/xuserfinduserbylocalid).

Pour récupérer un ID d'utilisateur pour un ID d'appareil donné, appelez [XUserFindForDevice](/fr-CA/reference/system/xuser/functions/xuserfindfordevice).

## 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 Series

## Documentation conceptuelle

* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Utilisation de l'API C++ de Game Chat 2](/fr-CA/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Voir aussi

[XUser](/fr-CA/reference/system/xuser/xuser_members)

[XUserFindUserByLocalId](/fr-CA/reference/system/xuser/functions/xuserfinduserbylocalid)

[XUserFindForDevice](/fr-CA/reference/system/xuser/functions/xuserfindfordevice)


## Related topics

- [XUserFindUserById](/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserFindUserByLocalId](/reference/system/xuser/functions/xuserfinduserbylocalid.md)