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

Recupera o XUserHandle com base na ID de usuário do XBOX (XUID) de um usuário local.

## Sintaxe

```cpp theme={null}
HRESULT XUserFindUserById(  
         uint64_t userId,  
         XUserHandle* handle  
)  
```

### Parâmetros

*userId*   \_In\_\
Tipo: uint64\_t

O usuário local para o qual recuperar o XUID.

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

Contém o XUID do usuário local.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou erro HRESULT.\
Para obter uma lista de códigos de erro, consulte [Códigos de erro](/pt-BR/reference/errorcodes).

## Comentários

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

Para cada identificador **XUserHandle** que você recuperar de uma API **XUser**, incluindo **XUserFindUserById**, você deve
fechar esse identificador chamando [XUserCloseHandle](/pt-BR/reference/system/xuser/functions/xuserclosehandle).

Para recuperar a ID de usuário do XBox (XUID) de um usuário local, chame XUserFindUserById.

Para recuperar um identificador para um usuário de uma ID de usuário local específica, chame [XUserFindUserByLocalId](/pt-BR/reference/system/xuser/functions/xuserfinduserbylocalid).

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

## 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)
* [Usando a API C++ do Game Chat 2](/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Confira também

[XUser](/pt-BR/reference/system/xuser/xuser_members)

[XUserFindUserByLocalId](/pt-BR/reference/system/xuser/functions/xuserfinduserbylocalid)

[XUserFindForDevice](/pt-BR/reference/system/xuser/functions/xuserfindfordevice)


## Related topics

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