Windows控制台关闭时不会发送SIGINT或SIGTERM，而是发送CTRL_CLOSE_EVENT事件；必须用SetConsoleCtrlHandler注册回调函数处理，返回TRUE可阻止默认终止并执行清理，但需避免阻塞操作。
Windows控制台关闭时程序会收到什么信号
Windows控制台窗口点击「关闭」（×）按钮时，系统不会发送 SIGINT 或 SIGTERM，而是向进程发送 CTRL_CLOSE_EVENT。这个事件默认会导致进程立即终止，不执行任何清理逻辑——这也是为什么你常看到资源没释放、文件没刷盘、日志没写完就退出了。
关键点在于：它不是 Unix 信号，不能用 signal() 捕获；必须通过 Windows API 的 SetConsoleCtrlHandler() 注册回调函数。
如何用 SetConsoleCtrlHandler 注册关闭处理函数
你需要提供一个符合 PHANDLER_ROUTINE 类型的回调函数，并在程序启动早期（比如 main() 开头）注册它。该函数会在控制台关闭、Ctrl+C、Ctrl+Break 等事件发生时被调用。
注意：回调函数必须是全局函数或 static 成员函数，不能是普通成员函数（因调用约定和 this 指针问题）。
立即学习“C++免费学习笔记（深入）”；
- 返回
TRUE表示你已处理该事件，系统将不再执行默认终止动作 - 返回
FALSE表示交还给系统处理（即直接退出） - 仅对控制台子系统（
/SUBSYSTEM:CONSOLE）有效；GUI 程序即使有控制台也不会触发
简单示例：
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南，适用于远程桌面访问、安全 RDP 等。
BOOL WINAPI ConsoleHandler(DWORD dwType) {
if (dwType == CTRL_CLOSE_EVENT) {
// 执行清理：关闭文件、释放内存、保存状态...
printf("正在安全退出...\n");
Sleep(500); // 模拟耗时清理
return TRUE; // 阻止默认关闭
}
return FALSE;
}
int main() {
SetConsoleCtrlHandler(ConsoleHandler, TRUE);
printf("运行中，尝试关闭控制台窗口\n");
while (true) { Sleep(1000); }
return 0;
}
为什么有时候 CTRL_CLOSE_EVENT 处理函数没被调用
常见原因不是代码写错，而是环境或链接配置问题：
- 项目配置为
/SUBSYSTEM:WINDOWS（GUI 子系统），即使调用AllocConsole()也收不到该事件 —— 必须用/SUBSYSTEM:CONSOLE - 使用了某些第三方库（如 Qt、SDL）接管了控制台或消息循环，可能屏蔽或延迟事件分发
- 回调函数里调用了不安全的 API（如
printf在多线程下可能崩溃），导致 handler 异常退出，系统回退到默认行为 - 在 DLL 中注册 handler 但主 EXE 未显式调用，或者 handler 被优化掉（加
__declspec(dllexport)或 static 修饰可避免）
验证是否生效：在 handler 中写入文件或弹出 MessageBox（仅调试用），比单纯打印更可靠，因为 printf 输出可能被缓冲且在进程终止前丢失。
清理逻辑里不能做什么
Windows 要求 handler 函数必须快速返回（通常建议 ≤ 5 秒），且禁止调用多数 GUI、I/O、同步等待类 API：
- 不要调用
WaitForSingleObject、WaitForMultipleObjects等阻塞等待 - 避免
CreateThread、MessageBox（除非是调试临时加的）、LoadLibrary - 不要做复杂文件操作（如大文件 flush），可用
FlushFileBuffers但需确保句柄有效且非网络路径 - 推荐做法：设一个原子标志（如
std::atomic<bool> g_shutdown_requested{false};</bool>），在 handler 中置位，主循环检测并主动退出
真正复杂的清理应放在主循环退出后、main() 返回前完成，handler 只负责“通知”和“请求”。否则容易触发系统强制终止（Application Hang）判定。
控制台关闭事件的响应窗口很窄，靠“做完再退出”不如“立刻响应、尽快收尾”。
