共用方式為


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)

另請參閱

CreateProcess

GetCurrentProcess

OpenProcess

處理序和執行緒函式