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

# Método IXtfUserClient::PairControllerWithUserId

> Método IXtfUserClient::PairControllerWithUserId

# Método IXtfUserClient::PairControllerWithUserId

Emparelha o usuário identificado pela ID de usuário especificada ao controle com a ID de controle especificada.

## Sintaxe

```cpp theme={null}
public:
HRESULT PairControllerWithUserId(
         UINT32 userId,
         UINT64 controllerId
)  
```

### Parâmetros

*userId*\
Tipo: UINT32

A ID de usuário 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 a ID de usuário 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 *userId*.

O emparelhamento de um controle usando **PairControllerWithUserId** é 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

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


## Related topics

- [Método IXtfUserClient::PairControllerWithUser](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Método IXtfUserClient::AddUser](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUserId](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SignoutUserId](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteUserId](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)