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

> IXtfUserClient::PairControllerWithUser Method

# IXtfUserClient::PairControllerWithUser Method

将由指定电子邮件地址标识的用户与具有指定控制器 ID 的控制器进行配对。

## 语法

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

### 参数

*userName*\
类型：LPCWSTR

要与控制器配对的用户的电子邮件地址。

*controllerId*\
类型：UINT64

控制器的控制器 ID。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

若要获取用户的电子邮件地址，请调用 [ListUsers](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)。在返回的 [XTF\_USER\_DATA](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) 结构中，检查 *pszEmailAddress* 成员。

使用 **PairControllerWithUser** 配对控制器是累加的。如果某个用户已与该控制器配对，则由 *userName* 指定的用户也会与该控制器配对。若要创建独占配对，请调用 **PairControllerWithUserIdExclusive** 或 **PairControllerWithUserExclusive**。

## 要求

**头文件：** xtfuser.h

**库：** xtfuser.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

[PairControllerWithUserId](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)


## Related topics

- [PairControllerWithUserId](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)
- [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [GetControllerAxisCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md)