Fonction UserHandleGrantAccess (winuser.h)

Article
08/28/2023

Accorde ou refuse l’accès à un handle à un objet User à un travail qui a une restriction d’interface utilisateur. Lorsque l’accès est accordé, tous les processus associés au travail peuvent ensuite reconnaître et utiliser le handle. Lorsque l’accès est refusé, les processus ne peuvent plus utiliser le handle. Pour plus d’informations, consultez Objets utilisateur.

Syntaxe

BOOL UserHandleGrantAccess(
  [in] HANDLE hUserHandle,
  [in] HANDLE hJob,
  [in] BOOL   bGrant
);

Paramètres

[in] hUserHandle

Handle de l’objet User.

[in] hJob

Handle du travail à accorder l’accès au handle utilisateur. La fonction CreateJobObject ou OpenJobObject retourne ce handle.

[in] bGrant

Si ce paramètre a la valeur TRUE, tous les processus associés au travail peuvent reconnaître et utiliser le handle. Si le paramètre est FALSE, les processus ne peuvent pas utiliser le handle.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction UserHandleGrantAccess peut être appelée uniquement à partir d’un processus non associé au travail spécifié par le paramètre hJob . Le handle utilisateur ne doit pas être détenu par un processus ou un thread associé au travail.

Pour créer des restrictions d’interface utilisateur, appelez la fonction SetInformationJobObject avec la classe d’informations sur le travail JobObjectBasicUIRestrictions.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll