UserHandleGrantAccess-Funktion (winuser.h)
Gewährt oder verweigert den Zugriff auf ein Handle für ein Benutzerobjekt für einen Auftrag, der über eine Benutzerschnittstelleneinschränkung verfügt. Wenn der Zugriff gewährt wird, können alle dem Auftrag zugeordneten Prozesse das Handle anschließend erkennen und verwenden. Wenn der Zugriff verweigert wird, können die Prozesse das Handle nicht mehr verwenden. Weitere Informationen finden Sie unter Benutzerobjekte.
Syntax
BOOL UserHandleGrantAccess(
[in] HANDLE hUserHandle,
[in] HANDLE hJob,
[in] BOOL bGrant
);
Parameter
[in] hUserHandle
Ein Handle für das User-Objekt.
[in] hJob
Ein Handle für den Auftrag, dem Zugriff auf das Benutzerhandle gewährt werden soll. Die Funktion CreateJobObject oder OpenJobObject gibt dieses Handle zurück.
[in] bGrant
Wenn dieser Parameter TRUE ist, können alle dem Auftrag zugeordneten Prozesse das Handle erkennen und verwenden. Wenn der Parameter FALSE ist, können die Prozesse das Handle nicht verwenden.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die UserHandleGrantAccess-Funktion kann nur von einem Prozess aufgerufen werden, der nicht dem durch den hJob-Parameter angegebenen Auftrag zugeordnet ist. Das Benutzerhandle darf sich nicht im Besitz eines Prozesses oder Threads befinden, der dem Auftrag zugeordnet ist.
Um Benutzeroberflächeneinschränkungen zu erstellen, rufen Sie die SetInformationJobObject-Funktion mit der JobObjectBasicUIRestrictions-Auftragsinformationsklasse auf.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |