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

# XUserFindUserByLocalId

> XUserFindUserByLocalId

# XUserFindUserByLocalId

Récupère un handle vers l'utilisateur correspondant à un ID d'utilisateur local spécifique.

## Syntaxe

```cpp theme={null}
HRESULT XUserFindUserByLocalId(  
         XUserLocalId userLocalId,  
         XUserHandle* handle  
)  
```

### Paramètres

*userLocalId*   \_In\_\
Type : [XUserLocalId](/fr/reference/system/xuser/structs/xuserlocalid)

ID local pour lequel obtenir l'utilisateur.

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

Contient un handle vers l'utilisateur associé à un ID d'utilisateur local spécifique.

### Valeur de retour

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

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

| Code de retour | Description |
| - | - |
| S\_OK | L'opération a réussi. |
| HRESULT\_FROM\_WIN32(ERROR\_NOT\_FOUND) | L'utilisateur est introuvable. |

## Remarques

Pour chaque handle **XUserHandle** que vous récupérez à partir d'une API **XUser**, y compris **XUserFindUserByLocalId**, vous devez
fermer ce handle en appelant [XUserCloseHandle](/fr/reference/system/xuser/functions/xuserclosehandle). Le nombre de références du handle augmente après l'appel des fonctions Get / Find.

Pour récupérer un handle vers un utilisateur correspondant à un ID d'utilisateur local spécifique, appelez XUserFindUserByLocalId.

Pour récupérer l'ID utilisateur XBOX (XUID) d'un utilisateur local, appelez [XUserFindUserById](/fr/reference/system/xuser/functions/xuserfinduserbyid).

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)

## Voir aussi

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

[XUserFindUserById](/fr/reference/system/xuser/functions/xuserfinduserbyid)

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


## Related topics

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