Condividi tramite


Funzione QueryInformationJobObject (jobapi2.h)

Recupera le informazioni relative al limite e allo stato del processo dall'oggetto processo.

Sintassi

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

Parametri

[in, optional] hJob

Handle per il processo di cui viene eseguita una query sulle informazioni. La funzione CreateJobObject o OpenJobObject restituisce questo handle. L'handle deve avere il diritto di accesso JOB_OBJECT_QUERY . Per altre informazioni, vedere Job Object Security and Access Rights.For more information, see Job Object Security and Access Rights.

Se questo valore è NULL e il processo chiamante è associato a un processo, viene utilizzato il processo associato al processo chiamante. Se il processo è annidato, viene usato il processo immediato del processo chiamante.

[in] JobObjectInformationClass

Classe di informazioni per i limiti su cui eseguire query. Questo parametro può avere uno dei valori seguenti.

Valore Significato
JobObjectBasicAccountingInformation
1
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_BASIC_ACCOUNTING_INFORMATION .
JobObjectBasicAndIoAccountingInformation
8
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION .
JobObjectBasicLimitInformation
2
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_BASIC_LIMIT_INFORMATION .
JobObjectBasicProcessIdList
3
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_BASIC_PROCESS_ID_LIST .
JobObjectBasicUIRestrictions
4
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_BASIC_UI_RESTRICTIONS .
JobObjectCpuRateControlInformation
15
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_CPU_RATE_CONTROL_INFORMATION .

Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo flag non è supportato.

JobObjectEndOfJobTimeInformation
6
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_END_OF_JOB_TIME_INFORMATION .
JobObjectExtendedLimitInformation
9
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_EXTENDED_LIMIT_INFORMATION .
JobObjectGroupInformation
11
Il parametro lpJobObjectInfo è un puntatore a un buffer che riceve l'elenco dei gruppi di processori a cui è attualmente assegnato il processo. La variabile a cui punta il parametro lpReturnLength viene impostata sulle dimensioni dei dati del gruppo. Dividere questo valore per sizeof(USHORT) per determinare il numero di gruppi.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo flag non è supportato.

JobObjectGroupInformationEx
14
Il parametro lpJobObjectInfo è un puntatore a un buffer che riceve una matrice di strutture GROUP_AFFINITY che indicano l'affinità del processo nei gruppi di processori a cui è attualmente assegnato il processo. La variabile a cui punta il parametro lpReturnLength è impostata sulle dimensioni dei dati di affinità di gruppo. Dividere questo valore per sizeof(GROUP_AFFINITY) per determinare il numero di gruppi.

Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo flag non è supportato.

JobObjectLimitViolationInformation
13
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_LIMIT_VIOLATION_INFORMATION .

Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo flag non è supportato.

JobObjectLimitViolationInformation2
34
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2 .

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 e Windows XP: questo flag non è supportato.

JobObjectNetRateControlInformation
32
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_NET_RATE_CONTROL_INFORMATION .

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 e Windows XP: questo flag non è supportato.

JobObjectNotificationLimitInformation
12
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION .

Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo flag non è supportato.

JobObjectNotificationLimitInformation2
33
Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2 .

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 e Windows XP: questo flag non è supportato.

JobObjectSecurityLimitInformation
5
Questo flag non è supportato. Le applicazioni devono impostare i limiti di sicurezza singolarmente per ogni processo. Windows Server 2003 e Windows XP: Il parametro lpJobObjectInfo è un puntatore a una struttura JOBOBJECT_SECURITY_LIMIT_INFORMATION .

[out] lpJobObjectInformation

Informazioni sul limite o sullo stato del processo. Il formato di questi dati dipende dal valore del parametro JobObjectInfoClass .

[in] cbJobObjectInformationLength

Conteggio delle informazioni sul processo su cui viene eseguito una query, in byte. Questo valore dipende dal valore del parametro JobObjectInfoClass .

[out, optional] lpReturnLength

Puntatore a una variabile che riceve la lunghezza dei dati scritti nella struttura a cui punta il parametro lpJobObjectInfo . Specificare NULL per non ricevere queste informazioni.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Usare QueryInformationJobObject per ottenere i limiti correnti e modificarli. Usare la funzione SetInformationJobObject per impostare nuovi limiti.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione jobapi2.h (includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

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

Oggetti processo

Funzioni di processi e thread

SetInformationJobObject