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

> IXtfUserClient::PairControllerWithUserId Method

# IXtfUserClient::PairControllerWithUserId Method

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

## Syntax

```cpp theme={null}
public:
HRESULT PairControllerWithUserId(
         UINT32 userId,
         UINT64 controllerId
)  
```

### Parameters

*userId*\
Type: UINT32

컨트롤러와 페어링할 사용자의 사용자 ID입니다.

*controllerId*\
Type: UINT64

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

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드.

## Remarks

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

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

## Requirements

**Header:** xtfuser.h

**Library:** xtfuser.lib

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

## See also

[PairControllerWithUser](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)


## Related topics

- [PairControllerWithUser](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient 인터페이스(인터페이스 목차)](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md)
- [PFAccountManagementSteamPlayFabIdPair](https://docs.xbox.com/ko/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementsteamplayfabidpair.md)
