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

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

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

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](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserclosehandle.md). 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](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfinduserbyid.md).

Pour récupérer un ID d'utilisateur correspondant à un ID d'appareil spécifique, appelez [XUserFindForDevice](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfindfordevice.md).

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

[XUserFindUserById](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfinduserbyid.md)

[XUserFindForDevice](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfindfordevice.md)


## Related topics

- [XUserFindUserById](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserLocalId](https://docs.xbox.com/fr/reference/system/xuser/structs/xuserlocalid.md)
- [XUserGetId](https://docs.xbox.com/fr/reference/system/xuser/functions/xusergetid.md)
- [XUser (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xuser/xuser_members.md)
- [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)