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

Détermine si un utilisateur possède un privilège donné.

## Syntaxe

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

### Paramètres

*user*   \_In\_\
Type : XUserHandle

Handle de l'utilisateur dont nous vérifions le privilège.

*options*   \_In\_\
Type : [XUserPrivilegeOptions](/fr-CA/reference/system/xuser/enums/xuserprivilegeoptions)

Options de privilège de l'utilisateur.

*privilege*   \_In\_\
Type : [XUserPrivilege](/fr-CA/reference/system/xuser/enums/xuserprivilege)

Privilège à vérifier.

*hasPrivilege*   \_Out\_\
Type : bool\*

True si l'utilisateur possède le privilège donné, false sinon.

*reason*   \_Out\_opt\_\
Type : [XUserPrivilegeDenyReason\*](/fr-CA/reference/system/xuser/enums/xuserprivilegedenyreason)

Raison pour laquelle l'utilisateur ne possède pas le privilège demandé.  Cette valeur est fournie **uniquement** à titre informatif et
peut être inexacte dans de nombreux scénarios.  Cette valeur **ne doit pas** servir à prendre des décisions dans votre titre.  Utilisez plutôt
[XUserResolvePrivilegeWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) pour résoudre tous les problèmes de privilège.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

| Code de retour | Description |
| - | - |
| S\_OK | L'opération a réussi. |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | L'utilisateur doit utiliser une interface utilisateur pour résoudre le problème. Appelez [XUserResolveIssueWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserresolveissuewithuiasync) pour afficher l'interface utilisateur à l'utilisateur. |

## Remarques

Détermine si l'utilisateur possède un [XUserPrivilege](/fr-CA/reference/system/xuser/enums/xuserprivilege) donné.

> <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" /> **REMARQUE :**  La valeur retournée dans l'argument *reason* est fournie **uniquement** à titre informatif et peut être inexacte dans de nombreux scénarios. Cette valeur **ne doit pas** servir à prendre des décisions dans votre titre.

Si un privilège est refusé (c.-à-d. que *hasPrivilege* est false), le jeu peut donner au joueur la possibilité de résoudre le problème de privilège en appelant [XUserResolvePrivilegeWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) avec la même valeur *privilege*.

Si cette méthode retourne **E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED**, le jeu peut donner au joueur la possibilité de résoudre le problème en appelant [XUserResolveIssueWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserresolveissuewithuiasync).

## Configuration requise

**En-tête :** XUser.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Utilisation côté client des privilèges d'utilisateur XBOX Live](/fr-CA/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client)

[XUser](/fr-CA/reference/system/xuser/xuser_members)

[XUserResolvePrivilegeWithUiAsync](/fr-CA/reference/system/xuser/functions/xuserresolveprivilegewithuiasync)


## Related topics

- [XUserCheckPrivilege](/reference/system/xuser/functions/xusercheckprivilege.md)
- [XUserPrivilege](/reference/system/xuser/enums/xuserprivilege.md)