Функция
GenerateConsoleCtrlEventФункция
GenerateConsoleCtrlEvent отправляет определяемый сигнал группе процессов консоли, которая совместно использует консоль, связанную с вызывающим процессом.Синтаксис
dwCtrlEvent , // созданный сигнал DWORD dwProcessGroupId // группа процессов, которая получит сигнал ); |
Параметры
dwCtrlEvent
[in] Тип сигнала, который создается. Этот параметр может быть одним из следующих значений
Значение |
Предназначение |
CTRL_C_EVENT |
Создает сигнал CTRL+C. |
CTRL_BREAK_EVENT |
Создает сигнал CTRL+BREAK. |
dwProcessGroupId
[in] Идентификатор группы процессов, которая получает сигнал. Группа процессов создается, когда установлен флажок
CREATE_NEW_PROCESS_GROUP при вызове функции CreateProcess. Идентификатор нового процесса является также идентификатором и группы новых процессов. Группа процессов включает в себя все процессы, которые являются потомками корневого процесса. Только те процессы в группе, которые совместно используют одну и ту же консоль, что и вызывающий процесс, получают сигнал. Другими словами, если процесс в группе создает новую консоль, этот процесс не получает сигнала, не создает своих потомков.Если этот параметр нулевой, сигнал создается для всех процессов, которые совместно используют консоль вызывающего процесса.
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите функцию
GetLastError.Замечания
Функция
GenerateConsoleCtrlEvent заставляет вызвать функции управления обработчиком процессов в целевой группе. Все консольные процессы имеют заданную по умолчанию функцию обработчика, которая вызывает функцию ExitProcess. Консольный процесс может использовать функцию SetConsoleCtrlHandler, чтобы установить или удалить другие функции обработчиков.Функция
SetConsoleCtrlHandler может также включить наследуемый атрибут, который заставляет вызывающий процесс игнорировать сигналы CTRL+C. Если функция GenerateConsoleCtrlEvent отправляет сигнал CTRL+C процессу, для которого этот атрибут включен, функции обработчиков для этого процесса не вызываются. Сигналы CTRL+BREAK всегда заставляют функции обработчика быть вызванными.Смотри также
Обзор консольных приложений, Функции консоли, CreateProcess, ExitProcess, SetConsoleCtrlHandler
Размещение и совместимость GenerateConsoleCtrlEvent |
|
Windows. NET Server |
Да |
Windows XP | Да |
Windows 2000 |
Да |
Windows NT |
Версия 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
Kernel32.lib |
Заголовочный файл |
|
- объявлено в |
Wincon.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |