UserHandleGrantAccess-Funktion (winuser.h)

Artikel
08/28/2023

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