> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-TW/reference/system/xuser/enums/xuserprivilegeoptions.md)

使用者權限選項。

*privilege*   \_In\_\
類型：[XUserPrivilege](https://docs.xbox.com/zh-TW/reference/system/xuser/enums/xuserprivilege.md)

要檢查的權限。

*hasPrivilege*   \_Out\_\
類型：bool\*

如果使用者具有特定權限，則為 True，否則為 false。

*reason*   \_Out\_opt\_\
類型：[XUserPrivilegeDenyReason\*](https://docs.xbox.com/zh-TW/reference/system/xuser/enums/xuserprivilegedenyreason.md)

使用者沒有所要求權限的原因。此值**僅**供參考，
在許多情況下可能不準確。您的遊戲**不應**使用此值來做出決策。請改為
使用 [XUserResolvePrivilegeWithUiAsync](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuserresolveprivilegewithuiasync.md) 來解決所有權限問題。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

| 傳回碼 | 描述 |
| - | - |
| S\_OK | 作業成功。 |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | 使用者必須使用 UI 來解決問題。請呼叫 [XUserResolveIssueWithUiAsync](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuserresolveissuewithuiasync.md) 向使用者顯示 UI。 |

## 備註

判斷使用者是否具有指定的 [XUserPrivilege](https://docs.xbox.com/zh-TW/reference/system/xuser/enums/xuserprivilege.md)。

> ![alert](https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/caution.gif?s=2e4f582499c4cb4859c57646638ae366) **注意：** *reason* 引數中傳回的值**僅**供參考，在許多情況下可能不準確。您的遊戲**不應**使用此值來做出決策。

如果權限遭到拒絕 (亦即 *hasPrivilege* 為 false)，遊戲可以使用相同的 *privilege* 值呼叫 [XUserResolvePrivilegeWithUiAsync](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuserresolveprivilegewithuiasync.md)，讓玩家有機會解決權限問題。

如果此方法傳回 **E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED**，遊戲可以呼叫 [XUserResolveIssueWithUiAsync](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuserresolveissuewithuiasync.md)，讓玩家有機會解決問題。

## 需求

**標頭：** XUser.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XBOX Live 使用者權限的用戶端使用方式](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)

[XUser](https://docs.xbox.com/zh-TW/reference/system/xuser/xuser_members.md)

[XUserResolvePrivilegeWithUiAsync](https://docs.xbox.com/zh-TW/reference/system/xuser/functions/xuserresolveprivilegewithuiasync.md)


## Related topics

- [XUserPrivilege](https://docs.xbox.com/zh-TW/reference/system/xuser/enums/xuserprivilege.md)
- [XUserPrivilegeOptions](https://docs.xbox.com/zh-TW/reference/system/xuser/enums/xuserprivilegeoptions.md)
- [XUserPrivilegeDenyReason](https://docs.xbox.com/zh-TW/reference/system/xuser/enums/xuserprivilegedenyreason.md)
- [XBOX 服務使用者權限的用戶端使用](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
- [XR-045 XBOX network 與帳戶權限](https://docs.xbox.com/zh-TW/publishing/certification/xr/xr-045.md)