Поделиться через

Функция 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

Тип объекта графического пользовательского интерфейса. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
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.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение — это количество дескрипторов объектов графического пользовательского интерфейса, используемых процессом. Если объекты графического пользовательского интерфейса не используются, возвращаемое значение равно нулю.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Процесс без графического пользовательского интерфейса не использует ресурсы графического пользовательского интерфейса, поэтому GetGuiResources возвращает ноль.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-misc-l1-1-0 (представлено в Windows 8)

См. также раздел

CreateProcess

GetCurrentProcess

OpenProcess

Функции процессов и потоков