getGuiResources 函数 (winuser.h)

检索图形用户界面 (GUI) 指定进程使用的对象的句柄计数。

语法

DWORD GetGuiResources(
  [in] HANDLE hProcess,
  [in] DWORD  uiFlags
);

[in] hProcess

进程的句柄。句柄必须引用当前会话中的进程，并且必须具有 PROCESS_QUERY_LIMITED_INFORMATION 访问权限， (请参阅进程安全性和访问权限) 。

如果此参数是 GR_GLOBAL的特殊值，则会在当前会话中的所有进程中报告资源使用情况。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：GR_GLOBAL值在 Windows 7 和 Windows Server 2008 R2 之前不受支持。

Windows Server 2003 和 Windows XP： 句柄必须具有 PROCESS_QUERY_INFORMATION 访问权限。

[in] uiFlags

GUI 对象类型。此参数的取值可为下列值之一：

值	含义
GR_GDIOBJECTS 0	返回 GDI 对象的计数。
GR_GDIOBJECTS_PEAK 2	返回 GDI 对象的峰值计数。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：在 Windows 7 和 Windows Server 2008 R2 之前，不支持此值。
GR_USEROBJECTS 1	返回 USER 对象的计数。
GR_USEROBJECTS_PEAK 4	返回 USER 对象的峰值计数。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：在 Windows 7 和 Windows Server 2008 R2 之前，不支持此值。

如果函数成功，则返回值是进程使用的 GUI 对象的句柄计数。如果未使用 GUI 对象，则返回值为零。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

没有图形用户界面的进程不使用 GUI 资源，因此 ，GetGuiResources 将返回零。


最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-misc-l1-1-0 (