> ## 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.

# XUserPrivilegeDenyReason

> XUserPrivilegeDenyReason

# XUserPrivilegeDenyReason

指定用户无法获取特权的原因。

## Syntax

```cpp theme={null}
enum class XUserPrivilegeDenyReason  : uint32_t  
{  
    None = 0,  
    PurchaseRequired = 1,  
    Restricted = 2,  
    Banned = 3,  
    Unknown = 0xFFFFFFFF  
}  
```

## Constants

| 常量               | 说明        |
| ---------------- | --------- |
| None             | 没有原因。     |
| PurchaseRequired | 用户必须进行购买。 |
| Restricted       | 存在对用户的限制。 |
| Banned           | 存在对用户的禁令。 |
| Unknown          | 未知原因。     |

## Remarks

若要检查用户是否具有特定特权，请调用 [XUserCheckPrivilege](/reference/system/xuser/functions/xusercheckprivilege) 函数。该函数接受指向 XUserPrivilegeDenyReason 枚举的指针作为参数。该函数返回 [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* 参数中返回的值**仅**用于提供信息，在许多情况下可能不准确。此值**不应**用于在标题中做出决策。

## Requirements

**头文件：** XUser.h

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## See also

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

[XUserCheckPrivilege](/reference/system/xuser/functions/xusercheckprivilege)

[XUserPrivilege](/reference/system/xuser/enums/xuserprivilege)


## Related topics

- [XBOX 服务用户特权的客户端使用](/zh-CN/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
- [XUserCheckPrivilege](/zh-CN/reference/system/xuser/functions/xusercheckprivilege.md)
- [XUser](/zh-CN/reference/system/xuser/xuser_members.md)
- [XblPermissionDenyReasonDetails](/zh-CN/reference/live/xsapi-c/privacy_c/structs/xblpermissiondenyreasondetails.md)
- [XblPermissionDenyReason](/zh-CN/reference/live/xsapi-c/privacy_c/enums/xblpermissiondenyreason.md)