IsProcessInJob-Funktion (jobapi.h)

Bestimmt, ob der Prozess im angegebenen Auftrag ausgeführt wird.

Syntax

BOOL IsProcessInJob(
  [in]           HANDLE ProcessHandle,
  [in, optional] HANDLE JobHandle,
  [out]          PBOOL  Result
);

Parameter

[in] ProcessHandle

Ein Handle für den zu testenden Prozess. Das Handle muss über das PROCESS_QUERY_INFORMATION- oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das PROCESS_QUERY_INFORMATION-Zugriffsrecht verfügen.

[in, optional] JobHandle

Ein Handle für den Auftrag. Wenn dieser Parameter NULL ist, testet die Funktion, ob der Prozess unter einem beliebigen Auftrag ausgeführt wird.

Wenn dieser Parameter nicht NULL ist, muss das Handle über das zugriffsrecht JOB_OBJECT_QUERY verfügen. Weitere Informationen finden Sie unter Auftragsobjektsicherheit und Zugriffsrechte.

[out] Result

Ein Zeiger auf einen Wert, der TRUE empfängt, wenn der Prozess im Auftrag ausgeführt wird, andernfalls FALSE.

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

Eine Anwendung kann kein Handle für das Auftragsobjekt abrufen, in dem sie ausgeführt wird, es sei denn, sie hat den Namen des Auftragsobjekts. Eine Anwendung kann jedoch die QueryInformationJobObject-Funktion mit NULL aufrufen, um Informationen zum Auftragsobjekt abzurufen.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0501 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 jobapi.h
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

AssignProcessToJobObject

Auftragsobjekte

Prozess- und Threadfunktionen

QueryInformationJobObject