> ## 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 a ID de usuário de uma ID de dispositivo específica.

## Sintaxe

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



```  
  
### Parâmetros  
  
*deviceId*   \_In\_  
Tipo: [APP_LOCAL_DEVICE_ID*](/pt-BR/reference/system/xuser/structs/app_local_device_id)  
  
A ID do dispositivo.  
*handle*   \_Out\_  
Tipo: XUserHandle*  
  
Contém o XUID do usuário local.  
  
### Valor retornado

Tipo: HRESULT
  
Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro.
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>

A associação entre usuário e dispositivo pode mudar por vários motivos:

* O usuário sai do console.
* Alguém usa o dispositivo de entrada para selecionar um usuário diferente no Seletor de Contas.

Para receber uma notificação quando a associação entre usuário e dispositivo for alterada, chame [XUserRegisterForDeviceAssociationChanged](/pt-BR/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged) para obter um [XUserDeviceAssociationChangedCallback](/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback).

<Note>*XUserFindForDevice* não pode retornar um identificador de usuário para um usuário que não tenha entrado com uma chamada para [XUserAddAsync](/pt-BR/reference/system/xuser/functions/xuseraddasync). Consulte [Usuários e dispositivos de entrada](/pt-BR/build/core-features/common/user/users-input-devices) para obter mais informações.</Note>

## Requisitos  
  
**Cabeçalho:** XUser.h
  
**Biblioteca:** xgameruntime.lib
  
**Plataformas com suporte:** Windows, 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)

## Confira também

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

[XUserDeviceAssociationChangedCallback](/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback)
````


## Related topics

- [XUserFindForDevice](/reference/system/xuser/functions/xuserfindfordevice.md)
- [XUserFindUserById](/reference/system/xuser/functions/xuserfinduserbyid.md)