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

# PairControllerWithUser

> Método IXtfUserClient::PairControllerWithUser

# Método IXtfUserClient::PairControllerWithUser

Emparelha o usuário identificado pelo endereço de email especificado ao controle com a ID de controle especificada.

## Sintaxe

```cpp theme={null}
public:
HRESULT PairControllerWithUser(
         LPCWSTR userName,
         UINT64 controllerId
)  
```

### Parâmetros

*userName*\
Tipo: LPCWSTR

O endereço de email do usuário a ser emparelhado com o controle.

*controllerId*\
Tipo: UINT64

A ID de controle do controle.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

Para obter o endereço de email do usuário, chame [ListUsers](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m). Na estrutura [XTF\_USER\_DATA](/pt-BR/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) retornada, examine o membro *pszEmailAddress*.

O emparelhamento de um controle usando **PairControllerWithUser** é cumulativo. Se um usuário já estiver emparelhado com o controle, o usuário especificado por *userName* também será emparelhado com o controle. Para criar um emparelhamento exclusivo, chame **PairControllerWithUserIdExclusive** ou **PairControllerWithUserExclusive**.

## Requisitos

**Cabeçalho:** xtfuser.h

**Biblioteca:** xtfuser.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[PairControllerWithUserId](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m)


## Related topics

- [PairControllerWithUserId](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [XUserFindControllerForUserWithUiAsync](/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)
- [XUserFindControllerForUserWithUiResult](/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [GameInputControllerInfo](/pt-BR/reference/input/gameinput/structs/gameinputcontrollerinfo.md)
- [Lidar com a perda do controle](/pt-BR/build/core-features/common/user/users-dealing-with-controller-loss.md)