Función IsProcessInJob (jobapi.h)

  • Artículo

Determina si el proceso se está ejecutando en el trabajo especificado.

Sintaxis

BOOL IsProcessInJob(
  [in]           HANDLE ProcessHandle,
  [in, optional] HANDLE JobHandle,
  [out]          PBOOL  Result
);

Parámetros

[in] ProcessHandle

Identificador del proceso que se va a probar. El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

Windows Server 2003 y Windows XP: El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION.

[in, optional] JobHandle

Identificador del trabajo. Si este parámetro es NULL, la función comprueba si el proceso se ejecuta en cualquier trabajo.

Si este parámetro no es NULL, el identificador debe tener el derecho de acceso JOB_OBJECT_QUERY. Para obtener más información, vea Seguridad de objetos de trabajo y derechos de acceso.

[out] Result

Puntero a un valor que recibe TRUE si el proceso se ejecuta en el trabajo y FALSE en caso contrario.

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

Una aplicación no puede obtener un identificador para el objeto de trabajo en el que se ejecuta a menos que tenga el nombre del objeto de trabajo. Sin embargo, una aplicación puede llamar a la función QueryInformationJobObject con NULL para obtener información sobre el objeto de trabajo.

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

Requisitos

Requisito Value
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 jobapi.h
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

AssignProcessToJobObject

Objetos de trabajo

Funciones de proceso y subproceso

QueryInformationJobObject