Skip to main content

XUserCheckPrivilege

Détermine si un utilisateur dispose d’un privilège spécifique.

Syntaxe

Paramètres

user   _In_
Type : XUserHandle
Handle de l’utilisateur dont nous vérifions le privilège. options   _In_
Type : XUserPrivilegeOptions
Options de privilège utilisateur. privilege   _In_
Type : XUserPrivilege
Privilège à vérifier. hasPrivilege   _Out_
Type : bool*
True si l’utilisateur dispose du privilège spécifique, false sinon. reason   _Out_opt_
Type : XUserPrivilegeDenyReason*
Raison pour laquelle l’utilisateur ne dispose pas du privilège demandé. Cette valeur est fournie uniquement à titre informatif et peut être inexacte dans de nombreux scénarios. Cette valeur ne doit pas être utilisée pour prendre des décisions dans votre titre. Utilisez plutôt XUserResolvePrivilegeWithUiAsync pour résoudre tous les problèmes de privilège.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

Détermine si l’utilisateur dispose d’un XUserPrivilege donné.
alert 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 être utilisée pour prendre des décisions dans votre titre.
Si un privilège est refusé (c’est-à-dire si hasPrivilege a la valeur false), le jeu peut donner au joueur la possibilité de résoudre le problème de privilège en appelant 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.

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 utilisateur XBOX Live XUser XUserResolvePrivilegeWithUiAsync
Last modified on October 6, 2026