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

# XUserFindUserById

> XUserFindUserById

# XUserFindUserById

Recupera el XUserHandle basándose en el identificador de usuario de XBOX (XUID) de un usuario local.

## Sintaxis

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

### Parámetros

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

El usuario local para el que se recupera el XUID.

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

Contiene el XUID del usuario local.

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.\
Para obtener una lista de los códigos de error, consulte [Códigos de error](https://docs.xbox.com/es/reference/errorcodes.md).

## Comentarios

> [!NOTE]
>
> No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

Para cada identificador **XUserHandle** que recupere de una API de **XUser**, incluida **XUserFindUserById**, debe
cerrar ese identificador llamando a [XUserCloseHandle](https://docs.xbox.com/es/reference/system/xuser/functions/xuserclosehandle.md).

Para recuperar el identificador de usuario de XBox (XUID) de un usuario local, llame a XUserFindUserById.

Para recuperar un identificador a un usuario para un identificador de usuario local específico, llame a [XUserFindUserByLocalId](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfinduserbylocalid.md).

Para recuperar un identificador de usuario para un identificador de dispositivo específico, llame a [XUserFindForDevice](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfindfordevice.md).

## Requisitos

**Encabezado:** XUser.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Uso de la API de C++ de Game Chat 2](https://docs.xbox.com/es/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)

## Consulte también

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

[XUserFindUserByLocalId](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfinduserbylocalid.md)

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


## Related topics

- [XUserFindUserByLocalId](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfinduserbylocalid.md)
- [XUserGetId](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetid.md)
- [Uso de la API de C++ de Game Chat 2](https://docs.xbox.com/es/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [XUser (contenido de la API)](https://docs.xbox.com/es/reference/system/xuser/xuser_members.md)
- [Uso de contenedores de C# para las API del GDK en el proyecto de Unity](https://docs.xbox.com/es/build/gdk-and-engines/unity/unity-api-wrappers.md)