Función QueryInformationJobObject (jobapi2.h)

Artículo
03/11/2023

Recupera la información de límite y estado del trabajo del objeto de trabajo.

Sintaxis

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

Parámetros

[in, optional] hJob

Identificador del trabajo cuya información se está consultando. La función CreateJobObject o OpenJobObject devuelve este identificador. El identificador debe tener el derecho de acceso JOB_OBJECT_QUERY . Para obtener más información, vea Derechos de acceso y seguridad de objetos de trabajo.

Si este valor es NULL y el proceso de llamada está asociado a un trabajo, se usa el trabajo asociado al proceso de llamada. Si el trabajo está anidado, se usa el trabajo inmediato del proceso de llamada.

[in] JobObjectInformationClass

Clase de información para los límites que se van a consultar. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
JobObjectBasicAccountingInformation 1	El parámetro lpJobObjectInfo es un puntero a una estructura JOBOBJECT_BASIC_ACCOUNTING_INFORMATION .
JobObjectBasicAndIoAccountingInformation 8	El parámetro lpJobObjectInfo es un puntero a una estructura de JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION .
JobObjectBasicLimitInformation 2	El parámetro lpJobObjectInfo es un puntero a una estructura de JOBOBJECT_BASIC_LIMIT_INFORMATION .
JobObjectBasicProcessIdList 3	El parámetro lpJobObjectInfo es un puntero a una estructura JOBOBJECT_BASIC_PROCESS_ID_LIST .
JobObjectBasicUIRestrictions 4	El parámetro lpJobObjectInfo es un puntero a una estructura JOBOBJECT_BASIC_UI_RESTRICTIONS .
JobObjectCpuRateControlInformation 15	El parámetro lpJobObjectInfo es un puntero a una estructura JOBOBJECT_CPU_RATE_CONTROL_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite.
JobObjectEndOfJobTimeInformation 6	El parámetro lpJobObjectInfo es un puntero a una estructura JOBOBJECT_END_OF_JOB_TIME_INFORMATION .
JobObjectExtendedLimitInformation 9	El parámetro lpJobObjectInfo es un puntero a una estructura de JOBOBJECT_EXTENDED_LIMIT_INFORMATION .
JobObjectGroupInformation 11	El parámetro lpJobObjectInfo es un puntero a un búfer que recibe la lista de grupos de procesadores a los que está asignado actualmente el trabajo. La variable a la que apunta el parámetro lpReturnLength se establece en el tamaño de los datos del grupo. Divida este valor por `sizeof(USHORT)` para determinar el número de grupos. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite.
JobObjectGroupInformationEx 14	El parámetro lpJobObjectInfo es un puntero a un búfer que recibe una matriz de estructuras de GROUP_AFFINITY que indican la afinidad del trabajo en los grupos de procesadores a los que está asignado actualmente el trabajo. La variable a la que apunta el parámetro lpReturnLength se establece en el tamaño de los datos de afinidad de grupo. Divida este valor por `sizeof(GROUP_AFFINITY)` para determinar el número de grupos. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite.
JobObjectLimitViolationInformation 13	El parámetro lpJobObjectInfo es un puntero a una estructura JOBOBJECT_LIMIT_VIOLATION_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite.
JobObjectLimitViolationInformation2 34	El parámetro lpJobObjectInfo es un puntero a una estructura 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 y Windows XP: esta marca no se admite.
JobObjectNetRateControlInformation 32	El parámetro lpJobObjectInfo es un puntero a una estructura 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 y Windows XP: esta marca no se admite.
JobObjectNotificationLimitInformation 12	El parámetro lpJobObjectInfo es un puntero a una estructura de JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION . Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite.
JobObjectNotificationLimitInformation2 33	El parámetro lpJobObjectInfo es un puntero a una estructura 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 y Windows XP: esta marca no se admite.
JobObjectSecurityLimitInformation 5	Esta marca no se admite. Las aplicaciones deben establecer límites de seguridad individualmente para cada proceso. Windows Server 2003 y Windows XP: El parámetro lpJobObjectInfo es un puntero a una estructura JOBOBJECT_SECURITY_LIMIT_INFORMATION .

[out] lpJobObjectInformation

Información de estado del trabajo o límite. El formato de estos datos depende del valor del parámetro JobObjectInfoClass .

[in] cbJobObjectInformationLength

Recuento de la información del trabajo que se consulta, en bytes. Este valor depende del valor del parámetro JobObjectInfoClass .

[out, optional] lpReturnLength

Puntero a una variable que recibe la longitud de los datos escritos en la estructura a la que apunta el parámetro lpJobObjectInfo . Especifique NULL para no recibir esta información.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Use QueryInformationJobObject para obtener los límites actuales y modificarlos. Use la función SetInformationJobObject para establecer nuevos límites.

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	jobapi2.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll