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

> IXtfUserClient::PairControllerWithUser Method

# IXtfUserClient::PairControllerWithUser Method

지정된 이메일 주소로 식별되는 사용자를 지정된 컨트롤러 ID의 컨트롤러와 페어링합니다.

## Syntax

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

### Parameters

*userName*\
Type: LPCWSTR

컨트롤러와 페어링할 사용자의 이메일 주소입니다.

*controllerId*\
Type: UINT64

컨트롤러의 컨트롤러 ID입니다.

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드.

## Remarks

사용자의 이메일 주소를 얻으려면 [ListUsers](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m)를 호출하세요. 반환된 [XTF\_USER\_DATA](/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) 구조체에서 *pszEmailAddress* 멤버를 살펴봅니다.

**PairControllerWithUser**를 사용하여 컨트롤러를 페어링하는 것은 누적됩니다. 이미 사용자가 컨트롤러와 페어링되어 있는 경우, *userName*으로 지정된 사용자도 컨트롤러와 페어링됩니다. 배타적 페어링을 만들려면 **PairControllerWithUserIdExclusive** 또는 **PairControllerWithUserExclusive**를 호출하세요.

## Requirements

**Header:** xtfuser.h

**Library:** xtfuser.lib

**Supported platforms:** Windows(XBOX 콘솔 도구용)

## See also

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


## Related topics

- [IXtfUserClient::PairControllerWithUserId Method](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::AddUser Method](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteUser](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::ListUsers](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUser](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md)