Функция GenerateConsoleCtrlEvent отправляет определяемый сигнал группе процессов консоли, которая совместно использует консоль, связанную с вызывающим процессом.

dwCtrlEvent

dwProcessGroupId

[in] Идентификатор группы процессов, которая получает сигнал. Группа процессов создается, когда установлен флажок CREATE_NEW_PROCESS_GROUP при вызове функции CreateProcess. Идентификатор нового процесса является также идентификатором и группы новых процессов. Группа процессов включает в себя все процессы, которые являются потомками корневого процесса. Только те процессы в группе, которые совместно используют одну и ту же консоль, что и вызывающий процесс, получают сигнал. Другими словами, если процесс в группе создает новую консоль, этот процесс не получает сигнала, не создает своих потомков.

Если этот параметр нулевой, сигнал создается для всех процессов, которые совместно используют консоль вызывающего процесса.

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

Функция GenerateConsoleCtrlEvent заставляет вызвать функции управления обработчиком процессов в целевой группе. Все консольные процессы имеют заданную по умолчанию функцию обработчика, которая вызывает функцию ExitProcess. Консольный процесс может использовать функцию SetConsoleCtrlHandler, чтобы установить или удалить другие функции обработчиков.

Функция SetConsoleCtrlHandler может также включить наследуемый атрибут, который заставляет вызывающий процесс игнорировать сигналы CTRL+C. Если функция GenerateConsoleCtrlEvent отправляет сигнал CTRL+C процессу, для которого этот атрибут включен, функции обработчиков для этого процесса не вызываются. Сигналы CTRL+BREAK всегда заставляют функции обработчика быть вызванными.

Обзор консольных приложений, Функции консоли, CreateProcess, ExitProcess, SetConsoleCtrlHandler