> ## 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 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 le XUID doit être récupéré.

*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/reference/errorcodes).

## Remarques

<Note>Il n'est pas sûr d'appeler cette fonction sur un thread à durée critique. Pour plus d'informations, consultez [Threads à durée critique](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 à partir d'une API **XUser**, y compris **XUserFindUserById**, vous devez
fermer ce handle en appelant [XUserCloseHandle](/fr/reference/system/xuser/functions/xuserclosehandle).

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

Pour récupérer un handle vers un utilisateur correspondant à un ID d'utilisateur local spécifique, appelez [XUserFindUserByLocalId](/fr/reference/system/xuser/functions/xuserfinduserbylocalid).

Pour récupérer un ID d'utilisateur correspondant à un ID d'appareil spécifique, appelez [XUserFindForDevice](/fr/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 à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Utilisation de l'API C++ Game Chat 2](/fr/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Voir aussi

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

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

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


## Related topics

- [XUserFindUserById](/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserFindUserByLocalId](/reference/system/xuser/functions/xuserfinduserbylocalid.md)
- [XUserGetId](/reference/system/xuser/functions/xusergetid.md)
- [Using the Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [使用 Game Chat 2 C++ API](/zh-CN/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)