Skip to main content

XUserCheckPrivilege

사용자가 특정 권한을 가지고 있는지 확인합니다.

구문

매개변수

user   _In_
형식: XUserHandle
권한을 확인할 사용자에 대한 핸들입니다. options   _In_
형식: XUserPrivilegeOptions
사용자 권한 옵션입니다. privilege   _In_
형식: XUserPrivilege
확인할 권한입니다. hasPrivilege   _Out_
형식: bool*
사용자가 특정 권한을 가지고 있으면 true이고, 그렇지 않으면 false입니다. reason   _Out_opt_
형식: XUserPrivilegeDenyReason*
사용자가 요청된 권한을 가지고 있지 않은 이유입니다. 이 값은 정보 제공용이며, 많은 시나리오에서 부정확할 수 있습니다. 이 값은 타이틀에서 결정을 내리는 데 사용해서는 안 됩니다. 대신, XUserResolvePrivilegeWithUiAsync를 사용하여 모든 권한 문제를 해결하십시오.

반환값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

설명

사용자가 지정된 XUserPrivilege를 가지고 있는지 여부를 확인합니다.
alert 참고: reason 인수에 반환되는 값은 정보 제공용이며, 많은 시나리오에서 부정확할 수 있습니다. 이 값은 타이틀에서 결정을 내리는 데 사용해서는 안 됩니다.
권한이 거부된 경우(즉, hasPrivilege가 false인 경우), 게임은 동일한 privilege 값을 사용하여 XUserResolvePrivilegeWithUiAsync를 호출하여 플레이어가 권한을 해결할 기회를 제공할 수 있습니다. 이 메서드가 E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED를 반환하는 경우, 게임은 XUserResolveIssueWithUiAsync를 호출하여 플레이어가 문제를 해결할 기회를 제공할 수 있습니다.

요구 사항

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

함께 보기

XBOX Live 사용자 권한의 클라이언트 측 사용 XUser XUserResolvePrivilegeWithUiAsync
마지막 수정일 2026년 8월 24일