EnumWindows
A version of this page is also available for
4/8/2010
This function enumerates all top-level windows on the screen by passing the handle to each window, in turn, to an application-defined callback function. EnumWindows continues until the last top-level window is enumerated or the callback function returns FALSE.
Syntax
BOOL EnumWindows(
WNDENUMPROC lpEnumFunc,
LPARAM lParam
);
Parameters
- lpEnumFunc
[in] Long pointer to an application-defined callback function. For more information, see EnumWindowsProc.
- lParam
[in, out] Specifies an application-defined value to be passed to the callback function.
Return Value
Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.
Remarks
The EnumWindows function does not enumerate child windows.
This function is more reliable than calling the GetWindow function in a loop. An application that calls GetWindow to perform this task risks being caught in an infinite loop or referencing a handle to a window that has been destroyed.
Requirements
| Header | winuser.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |