Skip to main content

​
XUserFindUserByLocalId

특정 로컬 사용자 ID에 대한 사용자 핸들을 가져옵니다.

​
구문

​
매개변수

userLocalId   _In_
형식: XUserLocalId 사용자를 가져올 로컬 ID입니다. handle   _Out_
형식: XUserHandle* 특정 로컬 사용자 ID와 연결된 사용자에 대한 핸들을 포함합니다.

​
반환값

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하십시오.
형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

​
설명

XUserFindUserByLocalId를 포함하여 XUser API에서 가져오는 각 XUserHandle 핸들에 대해 XUserCloseHandle을 호출하여 해당 핸들을 닫아야 합니다. Get / Find 함수를 호출한 후에는 핸들의 참조 카운트가 증가합니다. 특정 로컬 사용자 ID에 대한 사용자 핸들을 가져오려면 XUserFindUserByLocalId를 호출합니다. 로컬 사용자의 XBOX 사용자 ID(XUID)를 가져오려면 XUserFindUserById를 호출합니다. 특정 장치 ID에 대한 사용자 ID를 가져오려면 XUserFindForDevice를 호출합니다.

​
요구 사항

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

​
개념 문서

​
함께 보기

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

관련 항목

XUserFindUserByIdXUserLocalIdXUserGetIdXUserGDK용 Unity C# API 래퍼