Fonction QueryInformationJobObject (jobapi2.h)

Article
03/11/2023

Récupère les informations sur la limite et l’état du travail à partir de l’objet de travail.

Syntaxe

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

Paramètres

[in, optional] hJob

Handle du travail dont les informations sont interrogées. La fonction CreateJobObject ou OpenJobObject retourne ce handle. Le handle doit avoir le droit d’accès JOB_OBJECT_QUERY . Pour plus d’informations, consultez Sécurité et droits d’accès aux objets de travail.

Si cette valeur est NULL et que le processus appelant est associé à un travail, le travail associé au processus appelant est utilisé. Si le travail est imbriqué, le travail immédiat du processus appelant est utilisé.

[in] JobObjectInformationClass

Classe d’informations pour les limites à interroger. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
JobObjectBasicAccountingInformation 1	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_BASIC_ACCOUNTING_INFORMATION .
JobObjectBasicAndIoAccountingInformation 8	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION .
JobObjectBasicLimitInformation 2	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_BASIC_LIMIT_INFORMATION .
JobObjectBasicProcessIdList 3	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_BASIC_PROCESS_ID_LIST .
JobObjectBasicUIRestrictions 4	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_BASIC_UI_RESTRICTIONS .
JobObjectCpuRateControlInformation 15	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_CPU_RATE_CONTROL_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.
JobObjectEndOfJobTimeInformation 6	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_END_OF_JOB_TIME_INFORMATION .
JobObjectExtendedLimitInformation 9	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_EXTENDED_LIMIT_INFORMATION .
JobObjectGroupInformation 11	Le paramètre lpJobObjectInfo est un pointeur vers une mémoire tampon qui reçoit la liste des groupes de processeur auxquels le travail est actuellement affecté. La variable pointée vers par le paramètre lpReturnLength est définie sur la taille des données de groupe. Divisez cette valeur par `sizeof(USHORT)` pour déterminer le nombre de groupes. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.
JobObjectGroupInformationEx 14	Le paramètre lpJobObjectInfo est un pointeur vers une mémoire tampon qui reçoit un tableau de structures GROUP_AFFINITY qui indiquent l’affinité du travail dans les groupes de processeurs auxquels le travail est actuellement affecté. La variable pointée par le paramètre lpReturnLength est définie sur la taille des données d’affinité de groupe. Divisez cette valeur par `sizeof(GROUP_AFFINITY)` pour déterminer le nombre de groupes. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.
JobObjectLimitViolationInformation 13	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_LIMIT_VIOLATION_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.
JobObjectLimitViolationInformation2 34	Le paramètre lpJobObjectInfo est un pointeur vers une structure 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 et Windows XP : cet indicateur n’est pas pris en charge.
JobObjectNetRateControlInformation 32	Le paramètre lpJobObjectInfo est un pointeur vers une structure 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 et Windows XP : cet indicateur n’est pas pris en charge.
JobObjectNotificationLimitInformation 12	Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.
JobObjectNotificationLimitInformation2 33	Le paramètre lpJobObjectInfo est un pointeur vers une structure 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 et Windows XP : cet indicateur n’est pas pris en charge.
JobObjectSecurityLimitInformation 5	Cet indicateur n’est pas pris en charge. Les applications doivent définir des limites de sécurité individuellement pour chaque processus. Windows Server 2003 et Windows XP : Le paramètre lpJobObjectInfo est un pointeur vers une structure JOBOBJECT_SECURITY_LIMIT_INFORMATION .

[out] lpJobObjectInformation

Informations sur la limite ou l’état du travail. Le format de ces données dépend de la valeur du paramètre JobObjectInfoClass .

[in] cbJobObjectInformationLength

Nombre d’informations de travail interrogées, en octets. Cette valeur dépend de la valeur du paramètre JobObjectInfoClass .

[out, optional] lpReturnLength

Pointeur vers une variable qui reçoit la longueur des données écrites sur la structure pointée par le paramètre lpJobObjectInfo . Spécifiez NULL pour ne pas recevoir ces informations.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Utilisez QueryInformationJobObject pour obtenir les limites actuelles et les modifier. Utilisez la fonction SetInformationJobObject pour définir de nouvelles limites.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0500 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	jobapi2.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll