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

# XUserFindForDevice

> XUserFindForDevice

# XUserFindForDevice

Recupera el identificador de usuario para un identificador de dispositivo específico.

## Sintaxis

```cpp theme={null}
HRESULT XUserFindForDevice(  
         const APP_LOCAL_DEVICE_ID* deviceId,  
         XUserHandle* handle  
)  
```

### Parámetros

*deviceId*   \_In\_\
Tipo: [APP\_LOCAL\_DEVICE\_ID\*](https://docs.xbox.com/es/reference/system/xuser/structs/app_local_device_id.md)

El identificador del dispositivo.\
*handle*   \_Out\_\
Tipo: XUserHandle\*

Contiene el XUID del usuario local.

### Valor devuelto

Tipo: HRESULT

Devuelve S\_OK si se realiza correctamente; de lo contrario, devuelve un código de error.
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).

La asociación entre el usuario y el dispositivo puede cambiar por muchos motivos:

* El usuario cierra sesión en la consola.
* Alguien usa el dispositivo de entrada para seleccionar un usuario diferente en el Selector de cuentas.

Para recibir una notificación cuando cambie la asociación entre usuario y dispositivo, llame a [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/es/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md) para obtener un [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/es/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md).

> [!NOTE]
>
> *XUserFindForDevice* no puede devolver un identificador de usuario a un usuario que no haya iniciado sesión con una llamada a [XUserAddAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xuseraddasync.md). Consulte [Usuarios y dispositivos de entrada](https://docs.xbox.com/es/build/core-features/common/user/users-input-devices.md) para obtener más información.

## Requisitos

**Encabezado:** XUser.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, 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](https://docs.xbox.com/es/reference/system/xuser/xuser_members.md)

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

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


## Related topics

- [XUserFindUserById](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserFindUserByLocalId](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfinduserbylocalid.md)
- [APP_LOCAL_DEVICE_ID](https://docs.xbox.com/es/reference/system/xuser/structs/app_local_device_id.md)
- [Usuarios y dispositivos de entrada](https://docs.xbox.com/es/build/core-features/common/user/users-input-devices.md)
- [XUser (contenido de la API)](https://docs.xbox.com/es/reference/system/xuser/xuser_members.md)