GetGuiResources 是 Windows 下监控 GUI 句柄泄漏最直接高效的方法,通过 GR_GDIOBJECTS 和 GR_USEROBJECTS 分别获取 GDI 与 USER 句柄数,两者之和近似任务管理器显示值;它开销低、无需特权,但仅限本进程 GUI 类型句柄,不跨平台。

Windows 下用 GetGuiResources 获取当前进程句柄数最直接
想监控自己程序的句柄泄漏,GetGuiResources 是 Windows API 中唯一能快速拿到当前进程 GUI 句柄(包括窗口、菜单、光标、图标等)总数的函数。它不依赖 WMI 或性能计数器,调用开销极低,适合高频采样。
注意:它只统计本进程创建的 GUI 类型句柄(GDI_HANDLES 和 USER_HANDLES),不包含文件句柄、线程、事件等内核对象 —— 这类得用 NtQueryInformationProcess 配合 ProcessHandleCount,但需要 SeDebugPrivilege 权限,普通进程拿不到。
-
GetGuiResources(GetCurrentProcess(), GR_GDIOBJECTS)返回 GDI 句柄数(画笔、字体、位图等) -
GetGuiResources(GetCurrentProcess(), GR_USEROBJECTS)返回 USER 句柄数(窗口、菜单、钩子等) - 两者相加接近任务管理器“句柄数”列显示值(任务管理器底层也调用此 API)
- 返回 0 表示出错,需检查
GetLastError();常见错误是传入非法进程句柄,但用GetCurrentProcess()基本不会出问题
跨平台?别硬套 —— Linux/macOS 没有等价的全局句柄概念
C++ 标准库和 POSIX 都不提供“系统级句柄总数”接口。Linux 的 /proc/[pid]/fd/ 目录可列出当前进程打开的文件描述符数量,但这只是 open() 系统调用产生的 fd,不涵盖 socket、eventfd、timerfd 等所有内核对象,更不等于 Windows 的“句柄”语义。
macOS 类似,task_info() 可查 TASK_THREAD_TIMES_INFO,但没有公开接口暴露“句柄总数”。强行封装跨平台句柄统计层只会掩盖差异、引入误判。
- Linux 实战建议:用
scandir("/proc/self/fd", ...)统计/proc/self/fd下目录项个数,近似为 fd 数(注意排除自身 opendir 打开的 dirfd) - 不要尝试读取
/proc/sys/fs/file-nr—— 它是全系统已分配 file 结构体总数,含未使用的缓存,和单进程无关 - macOS 上可用
proc_pidinfo(..., PROC_PIDLISTFDS, ...),但返回的是 fd 数组,需手动计数,且仅限本进程
高频采样时 GetGuiResources 的性能与稳定性边界
这个函数本身很快(微秒级),但频繁调用仍可能触发 Windows 内部锁竞争,尤其在多线程 GUI 应用中。实测在 Win10 x64 上,每毫秒调用一次持续 10 秒,未见异常;但若在窗口过程(WndProc)里每 WM_PAINT 都调,可能轻微拖慢重绘。
- 推荐采样间隔 ≥ 100ms;调试泄漏时可临时设为 10ms,定位完立刻回调
- 避免在 DWM 合成线程或 UI 线程阻塞路径中调用(比如同步等待句柄统计结果再更新界面)
- 如果发现
GetGuiResources突然返回 0 且GetLastError()是ERROR_ACCESS_DENIED,说明进程权限被动态降级(如 UAC 提权后又回落),需改用异步轮询 + 错误静默处理
句柄数暴涨 ≠ 一定泄漏 —— 先看生命周期再下结论
监控到 USER 句柄从 50 跳到 300 不代表泄漏。典型误判场景:动态创建大量临时窗口(如 Tooltip、ComboBox 下拉)、反复 CreateFont/SelectObject 未 DeleteObject、Hook 安装后未 Unhook。
关键要区分“瞬时高峰”和“单调增长”。前者可能是正常交互负载,后者才值得深挖。
- 用
Process Explorer(Sysinternals)附加进程,按 Handle Type 排序,筛选Window或Section,看句柄堆栈(需 pdb)是否集中在某段代码 - 在疑似泄漏点前后打日志:
OutputDebugStringA输出GetGuiResources值 + 当前调用位置(__FILE__ + __LINE__) - Release 版本记得关闭日志输出,否则
OutputDebugStringA在无调试器时仍有微小开销
真正难的是那些间接引用:比如一个 HWND 被某个第三方库内部持有,你没调 CreateWindow 却看到 USER 句柄涨了——这时候得看库文档,或者用 ETW 抓 Win32kTrace 事件。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











