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

# XUserFindControllerForUserWithUiAsync

> XUserFindControllerForUserWithUiAsync

# XUserFindControllerForUserWithUiAsync

사용자에게 사용할 컨트롤러를 켜고 식별하도록 요청하는 대화 상자를
표시합니다.

## 구문

```cpp theme={null}
HRESULT XUserFindControllerForUserWithUiAsync(  
         XUserHandle user,  
         XAsyncBlock* async  
)  
```

### 매개변수

*user*   \_In\_\
형식: XUserHandle

컨트롤러를 찾을 사용자의 XUserHandle입니다.

*async*   \_In\_\
형식: XAsyncBlock\*

호출의 상태를 폴링하고 호출 결과를 가져오기 위한 XAsyncBlock입니다.

### 반환값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다. 오류 코드 목록은
[Error Codes](/reference/errorcodes)를 참조하십시오.

### 설명

데스크탑에서 이 함수는 UI를 표시하지 않습니다.

사용자가 선택한 컨트롤러의 결과를 얻는 방법에는 몇 가지가 있습니다.

1. [XUserFindControllerForUserWithUiResult](/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult)를 호출합니다.
   이는 현재 바인딩된 컨트롤러의 장치 ID를 반환합니다.
2. 사용자가 새 컨트롤러를 선택했을 때 발생하는
   [XUserDeviceAssociationChangedCallback](/reference/system/xuser/functions/xuserdeviceassociationchangedcallback)
   콜백에서 결과를 얻습니다.

## 요구 사항

**헤더:** XUser.h

**라이브러리:** xgameruntime.lib

**지원되는 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XUser](/reference/system/xuser/xuser_members)\
[컨트롤러 손실 처리(NDA 항목)](/build/core-features/common/user/users-dealing-with-controller-loss)


## Related topics

- [XUserFindControllerForUserWithUiResult](/ko/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md)
- [컨트롤러 손실 처리](/ko/build/core-features/common/user/users-dealing-with-controller-loss.md)
- [사용자-컨트롤러 연결이 언제 발생하나요?](/ko/build/core-features/common/user/users-timing-of-user-to-device-association.md)
- [XR-115 플레이 중 사용자 또는 컨트롤러 추가 및 제거](/ko/publishing/certification/xr/xr-115.md)
- [XBOX 인증 개요](/ko/publishing/certification/overview.md)
