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

# 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](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 *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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)


## Related topics

- [PairControllerWithUser](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-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)
- [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)
- [PFAccountManagementSteamPlayFabIdPair](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementsteamplayfabidpair.md)