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

Recupera un identificador al usuario para un identificador de usuario local específico.

## Sintaxis

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

### Parámetros

*userLocalId*   \_In\_\
Tipo: [XUserLocalId](/reference/system/xuser/structs/xuserlocalid)

El identificador local del que se obtiene el usuario.

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

Contiene un identificador al usuario asociado con un identificador de usuario local específico.

### Valor devuelto

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

Tipo: HRESULT

Código de éxito o de error HRESULT.

| Código de retorno                       | Descripción                            |
| --------------------------------------- | -------------------------------------- |
| S\_OK                                   | La operación se realizó correctamente. |
| HRESULT\_FROM\_WIN32(ERROR\_NOT\_FOUND) | No se encontró el usuario.             |

## Comentarios

Para cada identificador **XUserHandle** que recupere de una API de **XUser**, incluida **XUserFindUserByLocalId**, debe
cerrar ese identificador llamando a [XUserCloseHandle](/reference/system/xuser/functions/xuserclosehandle). El recuento de referencias del identificador aumenta después de llamar a las funciones Get / Find.

Para recuperar un identificador a un usuario para un identificador de usuario local específico, llame a XUserFindUserByLocalId.

Para recuperar el identificador de usuario de XBOX (XUID) de un usuario local, llame a [XUserFindUserById](/reference/system/xuser/functions/xuserfinduserbyid).

Para recuperar un identificador de usuario para un identificador de dispositivo específico, llame a [XUserFindForDevice](/reference/system/xuser/functions/xuserfindfordevice).

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

## Consulte también

[XUser](/reference/system/xuser/xuser_members)

[XUserFindUserById](/reference/system/xuser/functions/xuserfinduserbyid)

[XUserFindForDevice](/reference/system/xuser/functions/xuserfindfordevice)


## Related topics

- [XUserFindUserById](/es/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserLocalId](/es/reference/system/xuser/structs/xuserlocalid.md)
- [XUserGetId](/es/reference/system/xuser/functions/xusergetid.md)
- [XUser](/es/reference/system/xuser/xuser_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)