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

# XUserFindForDevice

> XUserFindForDevice

# XUserFindForDevice

특정 장치 ID에 대한 사용자 ID를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XUserFindForDevice(  
         const APP_LOCAL_DEVICE_ID* deviceId,  
         XUserHandle* handle  
)  
```

### 매개변수

*deviceId*   \_In\_\
형식: [APP\_LOCAL\_DEVICE\_ID\*](https://docs.xbox.com/ko/reference/system/xuser/structs/app_local_device_id.md)

장치의 ID입니다.\
*handle*   \_Out\_\
형식: XUserHandle\*

로컬 사용자의 XUID를 포함합니다.

### 반환값

형식: HRESULT

성공하면 S\_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
오류 코드 목록은 [Error Codes](https://docs.xbox.com/ko/reference/errorcodes.md)를 참조하십시오.

## 설명

> [!NOTE]
>
> 이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하십시오.

사용자와 장치 간의 연결은 다음과 같은 여러 이유로 변경될 수 있습니다.

* 사용자가 콘솔에서 로그아웃하는 경우.
* 누군가 입력 장치를 사용하여 계정 선택기에서 다른 사용자를 선택하는 경우.

사용자-장치 연결이 변경될 때 알림을 받으려면 [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md)를 호출하여 [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md)을 가져옵니다.

> [!NOTE]
>
> *XUserFindForDevice*는 [XUserAddAsync](https://docs.xbox.com/ko/reference/system/xuser/functions/xuseraddasync.md) 호출로 로그인하지 않은 사용자에 대해서는 사용자 핸들을 반환할 수 없습니다. 자세한 내용은 [사용자 및 입력 장치](https://docs.xbox.com/ko/build/core-features/common/user/users-input-devices.md)를 참조하십시오.

## 요구 사항

**헤더:** XUser.h

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

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

[XUser](https://docs.xbox.com/ko/reference/system/xuser/xuser_members.md)

[XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md)

[XUserDeviceAssociationChangedCallback](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md)


## Related topics

- [XUserFindUserById](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserfinduserbyid.md)
- [XUserFindUserByLocalId](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserfinduserbylocalid.md)
- [APP_LOCAL_DEVICE_ID](https://docs.xbox.com/ko/reference/system/xuser/structs/app_local_device_id.md)
- [사용자 및 입력 장치](https://docs.xbox.com/ko/build/core-features/common/user/users-input-devices.md)
- [XUser (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xuser/xuser_members.md)