XUserFindForDevice
특정 장치 ID에 대한 사용자 ID를 검색합니다.
구문
HRESULT XUserFindForDevice(
const APP_LOCAL_DEVICE_ID* deviceId,
XUserHandle* handle
)
매개 변수
deviceId _In_
형식: APP_LOCAL_DEVICE_ID*
장치 ID입니다.
handle _Out_
형식: XUserHandle*
로컬 사용자에 대한 XUID를 포함합니다.
반환 값
형식: HRESULT
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
사용자와 장치 간의 연결은 여러 가지 이유로 변경될 수 있습니다.
- 사용자가 본체에서 로그아웃합니다.
- 다른 사람이 입력 장치를 이용해 계정 선택기에서 다른 사용자를 선택합니다.
사용자-장치 연결 변경 시 알림을 받으려면 XUserRegisterForDeviceAssociationChanged를 호출해 XUserDeviceAssociationChangedCallback을 얻습니다.
참고 항목
XUserFindForDevice는 XUserAddAsync로 전화를 걸어 로그인하지 않은 사용자에게 사용자 핸들을 반환할 수 없습니다. 자세한 내용은 사용자 및 입력 장치를 참조하세요.
요건
헤더: XUser.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔