次の方法で共有


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 で導入)

関連項目

CreateProcess

GetCurrentProcess

OpenProcess

プロセス関数とスレッド関数