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： 在 Windows 7 和 Windows Server 2008 R2 之前，不支援 GR_GLOBAL 值。

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)
程式庫	User32.lib
DLL	User32.dll
API 集合	ext-ms-win-ntuser-misc-l1-1-0 (于 Windows 8)