EnumChildWindows

BOOL EnumChildWindows(hwndOwner, lpEnumFunc, lParam)
HWND hwndOwner;	/* handle of parent window	*/
WNDENUMPROC lpEnumFunc;	/* address of callback function	*/
LPARAM lParam;	/* application-defined value	*/

This function enumerates the child windows that belong to the specified parent window by passing the handle of each child window, in turn, to the application-supplied callback function pointed to by the lpEnumFunc parameter.

The EnumChildWindows function continues to enumerate windows until the called function returns zero or until the last child window has been enumerated.

Parameters

hwndOwner

Identifies the parent window whose child windows are to be enumerated.

lpEnumFunc

Is the procedure-instance address of the callback function. For more information about the callback function, see the description of the EnumChildProc callback function.

lParam

Specifies the value to be passed to the callback function for the application's use.

Return Value

The return value specifies nonzero if all child windows have been enumerated. Otherwise, it is zero.

Comments

This function does not enumerate pop-up windows that belong to the hwndOwner parameter.