Функция EnumDesktopWindows (winuser.h)

Статья
03/13/2024

Перечисляет все окна верхнего уровня, связанные с указанным рабочим столом. Он передает дескриптор каждому окну, в свою очередь, в определяемую приложением функцию обратного вызова.

Синтаксис

BOOL EnumDesktopWindows(
  [in, optional] HDESK       hDesktop,
  [in]           WNDENUMPROC lpfn,
  [in]           LPARAM      lParam
);

Параметры

[in, optional] hDesktop

Дескриптор рабочего стола, окна верхнего уровня которого должны быть перечислены. Этот дескриптор возвращается функцией CreateDesktop, GetThreadDesktop, OpenDesktop или OpenInputDesktop и должен иметь право доступа к DESKTOP_READOBJECTS . Дополнительные сведения см. в разделе Безопасность рабочего стола и права доступа.

Если этот параметр имеет значение NULL, используется текущий рабочий стол.

[in] lpfn

Указатель на определяемую приложением функцию обратного вызова EnumWindowsProc .

[in] lParam

Определяемое приложением значение, передаваемое функции обратного вызова.

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

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

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

Необходимо убедиться, что функция обратного вызова задает SetLastError в случае сбоя.

Windows Server 2003 и Windows XP/2000: Если на рабочем столе нет окон, GetLastError возвращает ERROR_INVALID_HANDLE.

Функция EnumDesktopWindows многократно вызывает функцию обратного вызова lpfn , пока не будет перечислено последнее окно верхнего уровня или функция обратного вызова не вернет значение FALSE.

Требования

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