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 オブジェクトが使用されていない場合、戻り値は 0 です。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

グラフィカルユーザーインターフェイスのないプロセスでは GUI リソースが使用されないため、 GetGuiResources は 0 を返します。


サポートされている最小のクライアント	Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (include windows.h)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-misc-l1-1-0 (Windows 8 で導入)