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

# 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](https://docs.xbox.com/pt-BR/reference/errorcodes.md).

### 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](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md).
   Isso retornará a ID do dispositivo do controle agora vinculado.
2. Obtenha o resultado do retorno de chamada [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md),
   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](https://docs.xbox.com/pt-BR/reference/system/xuser/xuser_members.md)\
[Lidando com a perda do controle (tópico sob NDA)](https://docs.xbox.com/pt-BR/build/core-features/common/user/users-dealing-with-controller-loss.md)


## Related topics

- [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [Lidar com a perda do controle](https://docs.xbox.com/pt-BR/build/core-features/common/user/users-dealing-with-controller-loss.md)
- [Quando ocorrem as associações entre usuário e controle?](https://docs.xbox.com/pt-BR/build/core-features/common/user/users-timing-of-user-to-device-association.md)
- [XUser (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xuser/xuser_members.md)
- [Requisitos do XBOX para jogos do XBOX](https://docs.xbox.com/pt-BR/publishing/certification/xbox-requirements.md)