> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserCheckPrivilege

> XUserCheckPrivilege

# XUserCheckPrivilege

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

## 구문

```cpp theme={null}
HRESULT XUserCheckPrivilege(  
         XUserHandle user,  
         XUserPrivilegeOptions options,  
         XUserPrivilege privilege,  
         bool* hasPrivilege,  
         XUserPrivilegeDenyReason* reason  
)  
```

### 매개변수

*user*   \_In\_\
형식: XUserHandle

권한을 확인할 사용자에 대한 핸들입니다.

*options*   \_In\_\
형식: [XUserPrivilegeOptions](/reference/system/xuser/enums/xuserprivilegeoptions)

사용자 권한 옵션입니다.

*privilege*   \_In\_\
형식: [XUserPrivilege](/reference/system/xuser/enums/xuserprivilege)

확인할 권한입니다.

*hasPrivilege*   \_Out\_\
형식: bool\*

사용자가 특정 권한을 가지고 있으면 true이고, 그렇지 않으면 false입니다.

*reason*   \_Out\_opt\_\
형식: [XUserPrivilegeDenyReason\*](/reference/system/xuser/enums/xuserprivilegedenyreason)

사용자가 요청된 권한을 가지고 있지 않은 이유입니다. 이 값은 **정보 제공용**이며,
많은 시나리오에서 부정확할 수 있습니다. 이 값은 타이틀에서 결정을 내리는 데 **사용해서는 안 됩니다**. 대신,
[XUserResolvePrivilegeWithUiAsync](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync)를 사용하여 모든 권한 문제를 해결하십시오.

### 반환값

형식: HRESULT

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

| 반환 코드                                       | 설명                                                                                                                                                 |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| S\_OK                                       | 작업이 성공했습니다.                                                                                                                                        |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | 사용자가 UI를 사용하여 문제를 해결해야 합니다. 사용자에게 UI를 표시하려면 [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync)를 호출합니다. |

## 설명

사용자가 지정된 [XUserPrivilege](/reference/system/xuser/enums/xuserprivilege)를 가지고 있는지 여부를 확인합니다.

> <img src="https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/caution.gif?s=2e4f582499c4cb4859c57646638ae366" alt="alert" width="11" height="11" data-path="images/gdk/reference/caution.gif" /> **참고:** *reason* 인수에 반환되는 값은 **정보 제공용**이며, 많은 시나리오에서 부정확할 수 있습니다. 이 값은 타이틀에서 결정을 내리는 데 **사용해서는 안 됩니다**.

권한이 거부된 경우(즉, *hasPrivilege*가 false인 경우), 게임은 동일한 *privilege* 값을 사용하여 [XUserResolvePrivilegeWithUiAsync](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync)를 호출하여 플레이어가 권한을 해결할 기회를 제공할 수 있습니다.

이 메서드가 **E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED**를 반환하는 경우, 게임은 [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync)를 호출하여 플레이어가 문제를 해결할 기회를 제공할 수 있습니다.

## 요구 사항

**헤더:** XUser.h

**라이브러리:** xgameruntime.lib

**지원되는 플랫폼:** Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XBOX Live 사용자 권한의 클라이언트 측 사용](/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client)

[XUser](/reference/system/xuser/xuser_members)

[XUserResolvePrivilegeWithUiAsync](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync)


## Related topics

- [XUserPrivilege](/ko/reference/system/xuser/enums/xuserprivilege.md)
- [XUserPrivilegeOptions](/ko/reference/system/xuser/enums/xuserprivilegeoptions.md)
- [XUserPrivilegeDenyReason](/ko/reference/system/xuser/enums/xuserprivilegedenyreason.md)
- [XR-045 XBOX network 및 계정 권한](/ko/publishing/certification/xr/xr-045.md)
- [XBOX 서비스 사용자 권한의 클라이언트 측 사용](/ko/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)