OpenJobObjectA-Funktion (winbase.h)
Öffnet ein vorhandenes Auftragsobjekt.
Syntax
HANDLE OpenJobObjectA(
[in] DWORD dwDesiredAccess,
[in] BOOL bInheritHandle,
[in] LPCSTR lpName
);
Parameter
[in] dwDesiredAccess
Der Zugriff auf das Auftragsobjekt. Bei diesem Parameter kann es sich um mindestens eine der Zugriffsberechtigungen des Auftragsobjekts handeln. Dieses Zugriffsrecht wird anhand eines beliebigen Sicherheitsdeskriptors für das Objekt überprüft.
[in] bInheritHandle
Wenn dieser Wert TRUE ist, erben von diesem Prozess erstellte Prozesse das Handle. Andernfalls erben die Prozesse dieses Handle nicht.
[in] lpName
Der Name des zu öffnenden Auftrags. Bei Namenvergleichen wird die Groß-/Kleinschreibung beachtet.
Diese Funktion kann Objekte in einem privaten Namespace öffnen. Weitere Informationen finden Sie unter Objektnamespaces.
Terminaldienste: Der Name kann ein Präfix "Global" oder "Local" aufweisen, um das Objekt explizit im globalen oder Sitzungsnamespace zu öffnen. Der Rest des Namens kann ein beliebiges Zeichen mit Ausnahme des umgekehrten Schrägstrichs (\) enthalten. Weitere Informationen finden Sie unter Kernelobjektnamespaces.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Auftrag. Das Handle bietet den angeforderten Zugriff auf den Auftrag.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Ein Fehler von ERROR_FILE_NOT_FOUND weist darauf hin, dass der in lpName angegebene Auftrag nicht vorhanden ist.
Hinweise
Um einem Auftrag einen Prozess zuzuordnen, verwenden Sie die Funktion AssignProcessToJobObject .
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0500 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (einschließlich Windows.h, Jobapi2.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |