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

# 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md). Na estrutura [XTF\_USER\_DATA](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)


## Related topics

- [PairControllerWithUserId](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Interface IXtfUserClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)
- [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [GameInputControllerInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputcontrollerinfo.md)