XUserFindUserByLocalId
특정 로컬 사용자 ID의 사용자에 대한 핸들을 검색합니다.
구문
HRESULT XUserFindUserByLocalId(
XUserLocalId userLocalId,
XUserHandle* handle
)
매개 변수
userLocalId _In_
형식: XUserLocalId
사용자를 가져올 로컬 ID입니다.
handle _Out_
형식: XUserHandle*
특정 로컬 사용자 ID와 연결된 사용자에 대한 핸들을 포함합니다.
반환 값
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 작업이 성공했습니다. |
| HRESULT_FROM_WIN32(ERROR_NOT_FOUND) | 사용자를 찾을 수 없습니다. |
비고
XUserFindUserByLocalId를 비롯한 XUser API에서 검색한 각 XUserHandle 핸들에 대해, XUserCloseHandle을 호출하여 핸들을 닫아야 합니다. Get/Find 함수를 호출한 후 핸들의 참조 횟수가 증가합니다.
특정 로컬 사용자 ID의 사용자에 대한 핸들을 검색하려면 XUserFindUserByLocalId를 호출합니다.
로컬 사용자의 XUID(Xbox User ID)를 검색하려면 XUserFindUserById를 호출합니다.
특정 장치 ID의 사용자 ID를 검색하려면 XUserFindForDevice를 호출합니다.
요건
헤더: XUser.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔