XUserCheckPrivilege
사용자에게 특정 권한이 있는지 판단합니다.
구문
HRESULT XUserCheckPrivilege(
XUserHandle user,
XUserPrivilegeOptions options,
XUserPrivilege privilege,
bool* hasPrivilege,
XUserPrivilegeDenyReason* reason
)
매개 변수
user _In_
형식: XUserHandle
확인 중인 권한을 가진 사용자에 대한 핸들입니다.
options _In_
형식: XUserPrivilegeOptions
사용자 권한 옵션입니다.
privilege _In_
형식: XUserPrivilege
확인할 권한입니다.
hasPrivilege _Out_
형식: bool*
사용자에게 특정 권한이 있으면 true이고, 그렇지 않으면 false입니다.
reason _Out_opt_
형식: XUserPrivilegeDenyReason*
사용자에게 요청된 권한이 없는 이유입니다. 이 값은 only이며 많은 시나리오에서 정확하지 않을 수 있습니다. 이 값은 타이틀에서 결정을 내리는 데 사용해서는 안 됩니다. 대신 XUserResolvePrivilegeWithUiAsync를 사용하여 모든 권한 문제를 해결합니다.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 작업이 성공했습니다. |
| E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED | 사용자는 반드시 UI를 사용해 문제를 해결해야 합니다. XUserResolveIssueWithUiAsync를 호출하여 사용자에게 UI를 표시합니다. |
비고
사용자에게 지정된 XUserPrivilege가 있는지를 확인합니다.
참고:reason 인수에 반환된 값은 정보 만 가능하며 많은 시나리오에서 부정확할 수 있습니다. 이 값은 타이틀에서 결정을 내리는 데 사용해서는 안 됩니다.
권한이 거부된 경우(예: hasPrivilege가 false인 경우) 게임은 동일한 권한 값으로 XUserResolvePrivilegeWithUiAsync를 호출하여 플레이어에게 권한을 해결할 수 있는 기회를 제공할 수 있습니다.
이 메서드가 E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED를 반환하는 경우 게임은 플레이어에게 XUserResolveIssueWithUiAsync를 호출하여 문제를 해결할 수 있는 기회를 제공할 수 있습니다.
요구 사항
헤더: XUser.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔