EnumDesktopWindows _BJNHV

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 CreateDesktopMIH.I, OpenDesktop6LUNHD, and GetThreadDesktopKX2GTY functions return a desktop handle.

lpfn

Points to an application-defined EnumWindowsProc_3TRRS 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 GetLastError11C2VS7.

Remarks

The EnumDesktopWindows function repeatedly invokes the lpfn callback function until the last window is enumerated or the callback function returns FALSE.