> ## 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 d'utilisateur pour un ID d'utilisateur local donné.

## Syntaxe

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

### Paramètres

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

ID local pour lequel obtenir l'utilisateur.

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

Contient un handle de l'utilisateur associé à un ID d'utilisateur local donné.

### Valeur de retour

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

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 d'une API **XUser**, y compris **XUserFindUserByLocalId**, vous devez
fermer ce handle en appelant [XUserCloseHandle](/fr-CA/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 d'utilisateur pour un ID d'utilisateur local donné, appelez XUserFindUserByLocalId.

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

Pour récupérer un ID d'utilisateur pour un ID d'appareil donné, appelez [XUserFindForDevice](/fr-CA/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 sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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

[XUserFindUserById](/fr-CA/reference/system/xuser/functions/xuserfinduserbyid.md)

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


## Related topics

- [XUserFindUserById](/fr-CA/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserLocalId](/fr-CA/reference/system/xuser/structs/xuserlocalid.md)
- [XUserGetId](/fr-CA/reference/system/xuser/functions/xusergetid.md)
- [XUser (contenu de l'API)](/fr-CA/reference/system/xuser/xuser_members.md)
- [Utilisation des wrappers C# pour les API du GDK dans votre projet Unity](/fr-CA/build/gdk-and-engines/unity/unity-api-wrappers.md)