QueryInformationJobObject-Funktion (jobapi2.h)

Artikel
08/24/2023

Ruft Limit- und Auftragsstatusinformationen aus dem Auftragsobjekt ab.

Syntax

BOOL QueryInformationJobObject(
  [in, optional]  HANDLE             hJob,
  [in]            JOBOBJECTINFOCLASS JobObjectInformationClass,
  [out]           LPVOID             lpJobObjectInformation,
  [in]            DWORD              cbJobObjectInformationLength,
  [out, optional] LPDWORD            lpReturnLength
);

Parameter

[in, optional] hJob

Ein Handle für den Auftrag, dessen Informationen abgefragt werden. Die Funktion CreateJobObject oder OpenJobObject gibt dieses Handle zurück. Das Handle muss über das zugriffsrecht JOB_OBJECT_QUERY verfügen. Weitere Informationen finden Sie unter Auftragsobjektsicherheit und Zugriffsrechte.

Wenn dieser Wert NULL ist und der aufrufende Prozess einem Auftrag zugeordnet ist, wird der dem aufrufenden Prozess zugeordnete Auftrag verwendet. Wenn der Auftrag geschachtelt ist, wird der unmittelbare Auftrag des aufrufenden Prozesses verwendet.

[in] JobObjectInformationClass

Die Informationsklasse für die abzufragten Grenzwerte. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
JobObjectBasicAccountingInformation 1	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_BASIC_ACCOUNTING_INFORMATION-Struktur .
JobObjectBasicAndIoAccountingInformation 8	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION-Struktur .
JobObjectBasicLimitInformation 2	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_BASIC_LIMIT_INFORMATION-Struktur .
JobObjectBasicProcessIdList 3	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_BASIC_PROCESS_ID_LIST Struktur.
JobObjectBasicUIRestrictions 4	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_BASIC_UI_RESTRICTIONS Struktur.
JobObjectCpuRateControlInformation 15	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_CPU_RATE_CONTROL_INFORMATION-Struktur . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectEndOfJobTimeInformation 6	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_END_OF_JOB_TIME_INFORMATION-Struktur .
JobObjectExtendedLimitInformation 9	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_EXTENDED_LIMIT_INFORMATION-Struktur .
JobObjectGroupInformation 11	Der lpJobObjectInfo-Parameter ist ein Zeiger auf einen Puffer, der die Liste der Prozessorgruppen empfängt, denen der Auftrag derzeit zugewiesen ist. Die Variable, auf die der lpReturnLength-Parameter verweist, wird auf die Größe der Gruppendaten festgelegt. Dividieren Sie diesen Wert durch `sizeof(USHORT)` , um die Anzahl der Gruppen zu bestimmen. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectGroupInformationEx 14	Der lpJobObjectInfo-Parameter ist ein Zeiger auf einen Puffer, der ein Array von GROUP_AFFINITY Strukturen empfängt, die die Affinität des Auftrags in den Prozessorgruppen angeben, denen der Auftrag derzeit zugewiesen ist. Die Variable, auf die der lpReturnLength-Parameter verweist, wird auf die Größe der Gruppenaffinitätsdaten festgelegt. Dividieren Sie diesen Wert durch `sizeof(GROUP_AFFINITY)` , um die Anzahl der Gruppen zu bestimmen. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectLimitViolationInformation 13	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_LIMIT_VIOLATION_INFORMATION-Struktur . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectLimitViolationInformation2 34	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2 Struktur. Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectNetRateControlInformation 32	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_NET_RATE_CONTROL_INFORMATION Struktur. Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectNotificationLimitInformation 12	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION Struktur. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectNotificationLimitInformation2 33	Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2-Struktur . Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.
JobObjectSecurityLimitInformation 5	Dieses Flag wird nicht unterstützt. Anwendungen müssen sicherheitsrelevante Grenzwerte für jeden Prozess einzeln festlegen. Windows Server 2003 und Windows XP: Der lpJobObjectInfo-Parameter ist ein Zeiger auf eine JOBOBJECT_SECURITY_LIMIT_INFORMATION-Struktur .

[out] lpJobObjectInformation

Die Grenzwert- oder Auftragsstatusinformationen. Das Format dieser Daten hängt vom Wert des Parameters JobObjectInfoClass ab.

[in] cbJobObjectInformationLength

Die Anzahl der abgefragten Auftragsinformationen in Bytes. Dieser Wert hängt vom Wert des Parameters JobObjectInfoClass ab.

[out, optional] lpReturnLength

Ein Zeiger auf eine Variable, die die Länge der Daten empfängt, die in die Struktur geschrieben werden, auf die der lpJobObjectInfo-Parameter verweist. Geben Sie NULL an, um diese Informationen nicht zu empfangen.

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

Verwenden Sie QueryInformationJobObject , um die aktuellen Grenzwerte abzurufen und zu ändern. Verwenden Sie die SetInformationJobObject-Funktion , um neue Grenzwerte festzulegen.

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


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	jobapi2.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll