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

Recupera um identificador para o usuário de uma ID de usuário local específica.

## Sintaxe

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

### Parâmetros

*userLocalId*   \_In\_\
Tipo: [XUserLocalId](https://docs.xbox.com/pt-BR/reference/system/xuser/structs/xuserlocalid.md)

A ID local para a qual obter o usuário.

*handle*   \_Out\_\
Tipo: XUserHandle\*

Contém um identificador para o usuário associado a uma ID de usuário local específica.

### Valor retornado

> [!NOTE]
>
> Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

Tipo: HRESULT

Código de sucesso ou erro HRESULT.

| Código de retorno | Descrição |
| - | - |
| S\_OK | A operação foi bem-sucedida. |
| HRESULT\_FROM\_WIN32(ERROR\_NOT\_FOUND) | O usuário não foi encontrado. |

## Comentários

Para cada identificador **XUserHandle** que você recuperar de uma API **XUser**, incluindo **XUserFindUserByLocalId**, você deve
fechar esse identificador chamando [XUserCloseHandle](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserclosehandle.md). A contagem de referências do identificador aumenta após a chamada de funções Get / Find.

Para recuperar um identificador para um usuário de uma ID de usuário local específica, chame XUserFindUserByLocalId.

Para recuperar a ID de usuário do XBOX (XUID) de um usuário local, chame [XUserFindUserById](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfinduserbyid.md).

Para recuperar uma ID de usuário de uma ID de dispositivo específica, chame [XUserFindForDevice](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindfordevice.md).

## Requisitos

**Cabeçalho:** XUser.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XUser](https://docs.xbox.com/pt-BR/reference/system/xuser/xuser_members.md)

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

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


## Related topics

- [XUserFindUserById](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserLocalId](https://docs.xbox.com/pt-BR/reference/system/xuser/structs/xuserlocalid.md)
- [XUserGetId](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetid.md)
- [XUser (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xuser/xuser_members.md)
- [Usar wrappers C# para APIs do GDK no seu projeto do Unity](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)