Fonction UserHandleGrantAccess (winuser.h)
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 |