> ## 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::PairControllerWithUser

> Método IXtfUserClient::PairControllerWithUser

# Método IXtfUserClient::PairControllerWithUser

Empareja el usuario identificado por la dirección de correo electrónico especificada con el mando con el identificador de mando especificado.

## Sintaxis

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

### Parámetros

*userName*\
Tipo: LPCWSTR

Dirección de correo electrónico del usuario que se va a emparejar con el mando.

*controllerId*\
Tipo: UINT64

Identificador de mando del mando.

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

## Comentarios

Para obtener la dirección de correo electrónico del usuario, llame a [ListUsers](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m). En la estructura [XTF\_USER\_DATA](/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) devuelta, examine el miembro *pszEmailAddress*.

El emparejamiento de un mando mediante **PairControllerWithUser** es aditivo. Si un usuario ya está emparejado con el mando, el usuario especificado por *userName* también se empareja con el mando. Para crear un emparejamiento exclusivo, llame a **PairControllerWithUserIdExclusive** o **PairControllerWithUserExclusive**.

## Requisitos

**Encabezado:** xtfuser.h

**Biblioteca:** xtfuser.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

## Consulte también

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


## Related topics

- [Método IXtfUserClient::PairControllerWithUserId](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Método IXtfUserClient::AddUser](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUser](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUserId](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteAllUsers](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteallusers-ixtfuserclient-xtfuser-xbox-windows-m.md)