Skip to main content

XUserCheckPrivilege

Determina si un usuario tiene un privilegio específico.

Sintaxis

Parámetros

user   _In_
Tipo: XUserHandle
Un identificador del usuario cuyo privilegio se está comprobando. options   _In_
Tipo: XUserPrivilegeOptions
Opciones de privilegios del usuario. privilege   _In_
Tipo: XUserPrivilege
El privilegio que se va a comprobar. hasPrivilege   _Out_
Tipo: bool*
True si el usuario tiene el privilegio específico; false en caso contrario. reason   _Out_opt_
Tipo: XUserPrivilegeDenyReason*
El motivo por el que el usuario no tiene el privilegio solicitado. Este valor es solo informativo y puede ser inexacto en muchos escenarios. Este valor no debe usarse para tomar decisiones en su título. En su lugar, use XUserResolvePrivilegeWithUiAsync para resolver todos los problemas de privilegios.

Valor devuelto

Tipo: HRESULT Código de error o de operación correcta HRESULT.

Comentarios

Determina si el usuario tiene un XUserPrivilege determinado.
alerta NOTA: El valor devuelto en el argumento reason es solo informativo y puede ser inexacto en muchos escenarios. Este valor no debe usarse para tomar decisiones en su título.
Si se deniega un privilegio (es decir, hasPrivilege es false), el juego puede dar al jugador la oportunidad de resolver el privilegio llamando a XUserResolvePrivilegeWithUiAsync con el mismo valor de privilege. Si este método devuelve E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED, el juego puede dar al jugador la oportunidad de resolver el problema llamando a XUserResolveIssueWithUiAsync.

Requisitos

Encabezado: XUser.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Uso del lado cliente de los privilegios de usuario de XBOX Live XUser XUserResolvePrivilegeWithUiAsync
Última modificación el 28 de agosto de 2026