Freigeben über


QueryInformationJobObject-Funktion (jobapi2.h)

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

Siehe auch

JOBOBJECT_BASIC_ACCOUNTING_INFORMATION

JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION

JOBOBJECT_BASIC_LIMIT_INFORMATION

JOBOBJECT_BASIC_PROCESS_ID_LIST

JOBOBJECT_BASIC_UI_RESTRICTIONS

JOBOBJECT_CPU_RATE_CONTROL_INFORMATION

JOBOBJECT_END_OF_JOB_TIME_INFORMATION

JOBOBJECT_EXTENDED_LIMIT_INFORMATION

JOBOBJECT_LIMIT_VIOLATION_INFORMATION

JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2

JOBOBJECT_NET_RATE_CONTROL_INFORMATION

JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION

JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2

JOBOBJECT_SECURITY_LIMIT_INFORMATION

Auftragsobjekte

Prozess- und Threadfunktionen

SetInformationJobObject