Función TerminateJobObject (jobapi2.h)
Finaliza todos los procesos asociados actualmente al trabajo. Si el trabajo está anidado, esta función finaliza todos los procesos asociados actualmente con el trabajo y todos sus trabajos secundarios en la jerarquía.
Sintaxis
BOOL TerminateJobObject(
[in] HANDLE hJob,
[in] UINT uExitCode
);
Parámetros
[in] hJob
Identificador del trabajo cuyos procesos se finalizarán. La función CreateJobObject o OpenJobObject devuelve este identificador. Este identificador debe tener el derecho de acceso JOB_OBJECT_TERMINATE. Para obtener más información, vea Derechos de acceso y seguridad de objetos de trabajo.
El identificador de cada proceso del objeto de trabajo debe tener el derecho de acceso PROCESS_TERMINATE. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.
[in] uExitCode
El código de salida que van a usar todos los procesos y subprocesos del objeto de trabajo. Use la función GetExitCodeProcess para recuperar el valor de salida de cada proceso. Use la función GetExitCodeThread para recuperar el valor de salida de cada subproceso.
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
No es posible que ninguno de los procesos asociados al trabajo posponga o controle la finalización. Es como si se llamara a TerminateProcess para cada proceso asociado al trabajo.
La terminación de un trabajo anidado finaliza además todos los objetos de trabajo secundarios. Los recursos usados por los trabajos terminados se cobran por la cadena de trabajos primaria en la jerarquía.
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, vea Usar 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 | jobapi2.h (incluya Windows.h, Jobapi2.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |