XUserFindUserById
로컬 사용자의 XUID(Xbox 사용자 ID)를 기반으로 XUserHandle을 검색합니다.
구문
HRESULT XUserFindUserById(
uint64_t userId,
XUserHandle* handle
)
매개 변수
userId _In_
형식: uint64_t
XUID를 검색할 로컬 사용자입니다.
handle _Out_
형식: XUserHandle*
로컬 사용자에 대한 XUID를 포함합니다.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
오류 코드 목록은 오류 코드를 참조하세요.
비고
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
XUserFindUserById를 비롯한 XUser API에서 검색한 각 XUserHandle 핸들에 대해, XUserCloseHandle을 호출하여 핸들을 닫아야 합니다.
로컬 사용자의 XUID(XBox User ID)를 검색하려면 XUserFindUserById를 호출합니다.
특정 로컬 사용자 ID의 사용자에 대한 핸들을 검색하려면 XUserFindUserByLocalId를 호출합니다.
특정 장치 ID의 사용자 ID를 검색하려면 XUserFindForDevice를 호출합니다.
요건
헤더: XUser.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔