Skip to main content

​
XUserFindForDevice

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

​
구문

​
매개변수

deviceId   _In_
형식: APP_LOCAL_DEVICE_ID* 장치의 ID입니다.
handle   _Out_
형식: XUserHandle* 로컬 사용자의 XUID를 포함합니다.

​
반환값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 Error Codes를 참조하십시오.

​
설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하십시오.
사용자와 장치 간의 연결은 다음과 같은 여러 이유로 변경될 수 있습니다.
  • 사용자가 콘솔에서 로그아웃하는 경우.
  • 누군가 입력 장치를 사용하여 계정 선택 도구에서 다른 사용자를 선택하는 경우.
사용자-장치 연결이 변경될 때 알림을 받으려면 XUserRegisterForDeviceAssociationChanged를 호출하여 XUserDeviceAssociationChangedCallback을 가져옵니다.
XUserFindForDevice는 XUserAddAsync 호출로 로그인하지 않은 사용자에 대해서는 사용자 핸들을 반환할 수 없습니다. 자세한 내용은 사용자 및 입력 장치를 참조하십시오.

​
요구 사항

헤더: XUser.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

​
개념 문서

​
함께 보기

XUser XUserRegisterForDeviceAssociationChanged XUserDeviceAssociationChangedCallback
마지막 수정일 2026년 8월 24일

관련 항목

XUserFindUserByIdXUserFindUserByLocalIdAPP_LOCAL_DEVICE_IDXUser사용자 및 입력 장치