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

# 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\*](/reference/system/xuser/structs/app_local_device_id)

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](/reference/errorcodes).

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

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](/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged) para obtener un [XUserDeviceAssociationChangedCallback](/reference/system/xuser/functions/xuserdeviceassociationchangedcallback).

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

## 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](/reference/system/xuser/xuser_members)

[XUserRegisterForDeviceAssociationChanged](/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged)

[XUserDeviceAssociationChangedCallback](/reference/system/xuser/functions/xuserdeviceassociationchangedcallback)


## Related topics

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