OpenJobObjectA-Funktion (winbase.h)

  • Artikel

Ö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

Siehe auch

AssignProcessToJobObject

Auftragsobjekte

Prozess- und Threadfunktionen