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

# IXtfUserClient::PairControllerWithUser 方法

> IXtfUserClient::PairControllerWithUser 方法

# IXtfUserClient::PairControllerWithUser 方法

將由指定電子郵件地址識別的使用者與具有指定控制器識別碼的控制器配對。

## 語法

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

### 參數

*userName*\
類型：LPCWSTR

要與控制器配對之使用者的電子郵件地址。

*controllerId*\
類型：UINT64

控制器的控制器識別碼。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

若要取得使用者的電子郵件地址，請呼叫 [ListUsers](/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m)。在傳回的 [XTF\_USER\_DATA](/zh-TW/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) 結構中，檢查 *pszEmailAddress* 成員。

使用 **PairControllerWithUser** 配對控制器是累加的。如果已有使用者與控制器配對，*userName* 所指定的使用者也會與該控制器配對。若要建立獨佔配對，請呼叫 **PairControllerWithUserIdExclusive** 或 **PairControllerWithUserExclusive**。

## 需求

**標頭：** xtfuser.h

**程式庫：** xtfuser.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

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


## Related topics

- [IXtfUserClient::PairControllerWithUserId 方法](/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::AddUser 方法](/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUser](/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUserId](/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteAllUsers](/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteallusers-ixtfuserclient-xtfuser-xbox-windows-m.md)