> ## 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](/zh-TW/reference/system/xuser/enums/xuserprivilegeoptions)

使用者權限選項。

*privilege*   \_In\_\
類型：[XUserPrivilege](/zh-TW/reference/system/xuser/enums/xuserprivilege)

要檢查的權限。

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

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

*reason*   \_Out\_opt\_\
類型：[XUserPrivilegeDenyReason\*](/zh-TW/reference/system/xuser/enums/xuserprivilegedenyreason)

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

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

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

## 備註

判斷使用者是否具有指定的 [XUserPrivilege](/zh-TW/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](/zh-TW/reference/system/xuser/functions/xuserresolveprivilegewithuiasync)，讓玩家有機會解決權限問題。

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

## 需求

**標頭：** XUser.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

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

[XUser](/zh-TW/reference/system/xuser/xuser_members)

[XUserResolvePrivilegeWithUiAsync](/zh-TW/reference/system/xuser/functions/xuserresolveprivilegewithuiasync)


## Related topics

- [XUserCheckPrivilege](/reference/system/xuser/functions/xusercheckprivilege.md)
- [XUserPrivilege](/reference/system/xuser/enums/xuserprivilege.md)
- [XUserPrivilegeOptions](/reference/system/xuser/enums/xuserprivilegeoptions.md)
- [Client-side use of XBOX services user privileges](/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
- [XUserPrivilegeDenyReason](/reference/system/xuser/enums/xuserprivilegedenyreason.md)