Compartir a través de


Función QueryInformationJobObject (jobapi2.h)

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

Vea también

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

Objetos de trabajo

Funciones de proceso y subproceso

SetInformationJobObject