Skip to main content

XUserGetLocalId

사용자의 고유한 게임 세션 ID를 가져옵니다.

구문

매개변수

user   _In_
형식: XUserHandle
로컬 ID를 가져올 사용자에 대한 핸들입니다. userLocalId   _Out_
형식: XUserLocalId*
사용자의 고유한 게임 세션 ID를 포함합니다.

반환값

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

설명

특정 사용자의 사용자 ID를 가져오려면 XUserGetId를 호출합니다. 특정 사용자의 상태를 가져오려면 XUserGetState를 호출합니다. 특정 사용자의 연령 그룹을 가져오려면 XUserGetAgeGroup을 호출합니다. XUserLocalId는 게임 세션 내에서 사용자를 고유하게 식별합니다. XUserHandle을 복제하는 경우 두 핸들 모두 동일한 XUserLocalId를 유지합니다. 게임 세션이 끝나면 동일한 사용자가 다음 세션 동안 다른 XUserLocalId를 가질 수 있습니다. 이러한 ID를 게임 세션 간에 사용자를 추적하는 데 사용하지 마십시오. 다음 예제는 XUserLocalId를 사용하여 사용자의 기본 오디오 엔드포인트를 가져오는 방법을 보여줍니다.

요구 사항

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

함께 보기

XUser XUserGetId XUserGetState XUserGetAgeGroup
마지막 수정일 2026년 8월 24일