Функция
EnumWindowsФункция
EnumWindows перечисляет все окна верхнего уровня на экране, передавая дескриптор каждого окна, в свою очередь, в определяемую программой функцию повторного вызова. EnumWindows действует до тех пор, пока последнее окно верхнего уровня не будет перечислено, или пока функция повторного вызова не возвратит значение ЛОЖЬ (FALSE).Синтаксис
lpEnumFunc, // указатель на функцию обратного вызова LPARAM lParam // определяемое программой значение ); |
Параметры
lpEnumFunc
[in] Указатель на определяемую программой функцию повторного вызова. Для получения дополнительной информации, см. статью Функция
EnumWindowsProc.lParam
[in] Устанавливает определяемое программой значение, которое будет передано в функцию повторного вызова.
Возвращаемые значения
Если функция завершилась успешно, возвращается значение отличное от нуля.
Если функция потерпела неудачу, возвращаемое значение - ноль. Чтобы получить расширенную информацию об ошибке вызовите функцию
GetLastError.Если
EnumWindowsProc возвращает значение нуль, величина возвращаемого значения также нуль.Замечания
Функция
EnumWindows не перечисляет дочерние окна, за исключением нескольких окон верхнего уровня, принадлежащих системе, которые имеют стиль WS_CHILD.Эта функция более надежна, чем вызов функции
GetWindow в цикле. Прикладная программа, которая вызывает GetWindow, чтобы выполнить эту задачу, рискует попасть в бесконечный цикл или на ссылку на дескриптор окна, которое было разрушено.Смотри также
Краткий обзор Окна, EnumChildWindows, EnumWindowsProc, GetWindow
|
Размещение и совместимость EnumWindows |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |