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

Determina si un usuario tiene un privilegio específico.

## Sintaxis

```cpp theme={null}
HRESULT XUserCheckPrivilege(  
         XUserHandle user,  
         XUserPrivilegeOptions options,  
         XUserPrivilege privilege,  
         bool* hasPrivilege,  
         XUserPrivilegeDenyReason* reason  
)  
```

### Parámetros

*user*   \_In\_\
Tipo: XUserHandle

Un identificador del usuario cuyo privilegio se está comprobando.

*options*   \_In\_\
Tipo: [XUserPrivilegeOptions](/reference/system/xuser/enums/xuserprivilegeoptions)

Opciones de privilegios del usuario.

*privilege*   \_In\_\
Tipo: [XUserPrivilege](/reference/system/xuser/enums/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\*](/reference/system/xuser/enums/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](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) para resolver todos los problemas de privilegios.

### Valor devuelto

Tipo: HRESULT

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

| Código devuelto                             | Descripción                                                                                                                                                                                                                    |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| S\_OK                                       | La operación se realizó correctamente.                                                                                                                                                                                         |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | El usuario debe usar una interfaz de usuario para resolver el problema. Llame a [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync) para mostrar la interfaz de usuario al usuario. |

## Comentarios

Determina si el usuario tiene un [XUserPrivilege](/reference/system/xuser/enums/xuserprivilege) determinado.

> <img src="https://mintcdn.com/microsoft-4404708b/-_0FrcE2bDxzGxv-/images/gdk/reference/caution.gif?s=2e4f582499c4cb4859c57646638ae366" alt="alerta" width="11" height="11" data-path="images/gdk/reference/caution.gif" /> **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](/reference/system/xuser/functions/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](/reference/system/xuser/functions/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](/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client)

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

[XUserResolvePrivilegeWithUiAsync](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync)


## Related topics

- [XUserPrivilege](/es/reference/system/xuser/enums/xuserprivilege.md)
- [XUserPrivilegeOptions](/es/reference/system/xuser/enums/xuserprivilegeoptions.md)
- [XUserPrivilegeDenyReason](/es/reference/system/xuser/enums/xuserprivilegedenyreason.md)
- [XR-045 Red de XBOX y privilegios de cuenta](/es/publishing/certification/xr/xr-045.md)
- [Uso en el cliente de los privilegios de usuario de los servicios XBOX](/es/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)