Функция HandlerRoutine является программно-определяемой функцией, которая используется с функцией SetConsoleCtrlHandler. Консольный процесс использует эту функцию для обработки управляющих сигналов, полученных процессом. Когда сигнал принимается, система создает в этом процессе поток для выполнения этой функции.

Тип PHANDLER_ROUTINE определяет указатель на эту функцию повторного вызова. HandlerRoutine - имя - заместитель для программно-определяемого имени функции.

[in] Обозначает тип управляющего сигнала, полученного обработчиком. Это значение является одним из ниже перечисленных сигналов:

Если функция обрабатывает управляющий сигнал, она должна возвратить ИСТИНА (TRUE). Если она возвращает значение ЛОЖЬ (FALSE), используется следующая функция обработчика в списке обработчиков для этого процесса.

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

Каждый консольный процесс имеет свой собственный список функций HandlerRoutine. Вначале, этот список содержит только заданную по умолчанию функцию обработчика, которая вызывает ExitProcess. Консольный процесс добавляет или удаляет дополнительные функции обработчика путем вызова функции SetConsoleCtrlHandler, которая не затрагивает список функций обработчиков для других процессов. Когда консольный процесс получает какой-либо из управляющих сигналов, его функции обработчиков вызывают последний из зарегистрированных, основываясь на первом из вызванных до тех пор, пока один из обработчиков не возвратит ИСТИНА (TRUE). Если ни один из обработчиков не возвращает значение ИСТИНА (TRUE), вызывается заданный по умолчанию обработчик.

Сигналы CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT и CTRL_SHUTDOWN_EVENT дают процессу возможность очиститься перед завершением. Функция HandlerRoutine может выполнить любую необходимую очистку, затем сделать одно из ниже перечисленных действий:

• Вызвать функцию ExitProcess, чтобы завершить работу процесса.
• Возвратить значение ЛОЖЬ (FALSE). Если ни одна из зарегистрированных функций не возвращает значение обработчика ИСТИНА (TRUE), заданный по умолчанию обработчик завершает работу процесса.
• Возвратить значение ИСТИНА (TRUE). В данном случае, никакие другие функции обработчиков не вызываются, а система показывает на экране выскакивающее диалоговое окно, которое спрашивает пользователя, завершать ли работу процесса. Система также показывает на экране диалоговое окно, если процесс не отвечает в пределах некоторого промежутка времени задержки (5 секунд для CTRL_CLOSE_EVENT, и 20 секунд для CTRL_LOGOFF_EVENT и CTRL_SHUTDOWN_EVENT).

Процесс может использовать функцию SetProcessShutdownParameters, чтобы воспрепятствовать системе показывать на экране диалоговое окно для пользователя, по которому он заканчивает работу в сети или выключает систему. В этом случае, система завершает работу процесса тогда, когда HandlerRoutine возвращает значение ИСТИНА (TRUE), или когда истекает период блокировки по времени.

Когда консольная программа запущена как модуль обслуживания, она получает модифицированный заданный по умолчанию консольный управляющий обработчик. Этот измененный обработчик не вызывает функцию ExitProcess при обработке сигнала CTRL_LOGOFF_EVENT. Он позволяет модулю обслуживания продолжать запускаться после того, как пользователь заканчивает работу в сети. Если модуль обслуживания устанавливает свой собственный консольный управляющий обработчик, этот обработчик вызывается перед заданным по умолчанию обработчиком. Если установленный обработчик вызывает функцию ExitProcess при обработке сигнала CTRL_LOGOFF_EVENT, модуль обслуживания прекращает работу, когда пользователь заканчивает работу в сети.

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