Skip to main content

XUserFindUserById

로컬 사용자의 XBOX 사용자 ID(XUID)를 기반으로 XUserHandle을 가져옵니다.

구문

매개변수

userId   _In_
형식: uint64_t
XUID를 가져올 로컬 사용자입니다. handle   _Out_
형식: XUserHandle*
로컬 사용자의 XUID를 포함합니다.

반환값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.
오류 코드 목록은 Error Codes를 참조하십시오.

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하십시오.
XUserFindUserById를 포함하여 XUser API에서 가져오는 각 XUserHandle 핸들에 대해 XUserCloseHandle을 호출하여 해당 핸들을 닫아야 합니다. 로컬 사용자의 XBOX 사용자 ID(XUID)를 가져오려면 XUserFindUserById를 호출합니다. 특정 로컬 사용자 ID에 대한 사용자 핸들을 가져오려면 XUserFindUserByLocalId를 호출합니다. 특정 장치 ID에 대한 사용자 ID를 가져오려면 XUserFindForDevice를 호출합니다.

요구 사항

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

개념 문서

함께 보기

XUser XUserFindUserByLocalId XUserFindForDevice
마지막 수정일 2026년 8월 24일