Skip to main content

XUserCheckPrivilege

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

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 de l’utilisateur. privilege   _In_
Type : 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*
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 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 possède 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 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 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 d’utilisateur XBOX Live XUser XUserResolvePrivilegeWithUiAsync
Last modified on October 6, 2026