Funzione QueryInformationJobObject (jobapi2.h)

Articolo
08/24/2023

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