Функция TerminateJobObject

Функция TerminateJobObject завершает работу всех процессов, в настоящее время связанных с заданием.

Синтаксис
BOOL TerminateJobObject(
  HANDLE hJob,    // дескриптор задания
  UINT uExitCode  // код выхода
);

Параметры

hJob

[in] Дескриптор задания, процессы которого должен быть завершены. Функция CreateJobObject или OpenJobObject возвращает этот дескриптор. Этот дескриптор должен иметь право доступа JOB_OBJECT_TERMINATE. Для получения дополнительной информации, см. Защита объекта задания и права доступа.

uExitCode

[in] Код выхода, который будет использоваться процессами и потоками, завершающими свою работу в результате этого вызова. Используйте функцию GetExitCodeProcess, чтобы извлечь значение выхода процесса. Используйте функцию GetExitCodeThread, чтобы извлечь значение выхода потока.

Возвращаемые значения

Если функция завершается успешно, величина возвращаемого значения - не ноль.

Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получить дополнительные данные об ошибках, вызовите GetLastError.

Замечания

Любой из процессов, связанных с заданием не имеет возможности, чтобы отложить или управлять операцией завершения. Это, как если бы функция TerminateProcess запрашивала каждый процесс, связанный с заданием.

Чтобы компилировать приложение, которое использует эту функцию, определите макрокоманду _WIN32_WINNT как 0x0500 или позже. Для получения дополнительной информации, см. статью Использование заголовков SDK.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, CreateJobObject, OpenJobObject, TerminateProcess

Размещение и совместимость TerminateJobObject

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz