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

# XUserFindControllerForUserWithUiAsync

> XUserFindControllerForUserWithUiAsync

# XUserFindControllerForUserWithUiAsync

Mostra uma caixa de diálogo que solicitará ao usuário que ligue e identifique qual controle
deseja usar.

## Sintaxe

```cpp theme={null}
HRESULT XUserFindControllerForUserWithUiAsync(  
         XUserHandle user,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*user*   \_In\_\
Tipo: XUserHandle

O XUserHandle do usuário para o qual encontrar um controle.

*async*   \_In\_\
Tipo: XAsyncBlock\*

Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou erro HRESULT. Para obter uma lista de códigos de erro, consulte
[Códigos de erro](/pt-BR/reference/errorcodes).

### Comentários

Na área de trabalho, esta função não mostrará a interface do usuário.

Para obter os resultados de qual controle o usuário selecionou, há algumas opções.

1. Chame [XUserFindControllerForUserWithUiResult](/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult).
   Isso retornará a ID do dispositivo do controle agora vinculado.
2. Obtenha o resultado do retorno de chamada [XUserDeviceAssociationChangedCallback](/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback),
   que ocorrerá quando o usuário tiver selecionado o novo controle.

## Requisitos

**Cabeçalho:** XUser.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XUser](/pt-BR/reference/system/xuser/xuser_members)\
[Lidando com a perda do controle (tópico sob NDA)](/pt-BR/build/core-features/common/user/users-dealing-with-controller-loss)


## Related topics

- [XUserFindControllerForUserWithUiAsync](/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)
- [XUserFindControllerForUserWithUiResult](/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)