The EnumDesktopWindows function enumerates all windows in a desktop by passing the handle of each window, in turn, to an application-defined callback function.
BOOL EnumDesktopWindows(
| HDESK hDesktop, | // handle to desktop to enumerate |
| WNDENUMPROC lpfn, | // points to application's callback function |
| LPARAM lParam | // 32-bit value to pass to the callback function |
| ); |
Parameters
hDesktop
Specifies the handle to the desktop whose windows are to be enumerated. The CreateDesktop, OpenDesktop, and GetThreadDesktop functions return a desktop handle.
lpfn
Points to an application-defined EnumWindowsProc callback function.
lParam
Specifies a 32-bit application-defined value to be passed to the callback function.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
The EnumDesktopWindows function repeatedly invokes the lpfn callback function until the last window is enumerated or the callback function returns FALSE.
See Also
CreateDesktop, EnumWindowsProc, GetThreadDesktop, OpenDesktop