Функция EnumDesktopWindows (winuser.h)
Перечисляет все окна верхнего уровня, связанные с указанным рабочим столом. Он передает дескриптор каждому окну, в свою очередь, в определяемую приложением функцию обратного вызова.
Синтаксис
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) |