Skip to main content

XUserCheckPrivilege

确定用户是否具有特定权限。

语法

参数

user   _In_
类型:XUserHandle
要检查其权限的用户的句柄。 options   _In_
类型:XUserPrivilegeOptions
用户权限选项。 privilege   _In_
类型:XUserPrivilege
要检查的权限。 hasPrivilege   _Out_
类型:bool*
如果用户具有该特定权限,则为 True;否则为 false。 reason   _Out_opt_
类型:XUserPrivilegeDenyReason*
用户不具备所请求权限的原因。此值供参考,在许多场景中可能不准确。不应使用此值在标题中做决策。请改用 XUserResolvePrivilegeWithUiAsync 来解决所有权限问题。

返回值

类型:HRESULT HRESULT 成功或错误代码。

注解

确定用户是否具有给定的 XUserPrivilege
alert 注意: reason 参数中返回的值供参考,在许多场景中可能不准确。不应使用此值在标题中做决策。
如果权限被拒绝(即 hasPrivilege 为 false),游戏可以通过使用相同的 privilege 值调用 XUserResolvePrivilegeWithUiAsync,为玩家提供解决权限问题的机会。 如果此方法返回 E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED,游戏可以通过调用 XUserResolveIssueWithUiAsync,为玩家提供解决该问题的机会。

要求

头文件: XUser.h 库: xgameruntime.lib 支持的平台: Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

另请参阅

客户端使用 XBOX Live 用户权限 XUser XUserResolvePrivilegeWithUiAsync
最后修改于 2026年8月24日