Función EnumChildWindows (winuser.h)

Artículo
03/04/2024

Enumera las ventanas secundarias que pertenecen a la ventana primaria especificada pasando el identificador a cada ventana secundaria, a su vez, a una función de devolución de llamada definida por la aplicación. EnumChildWindows continúa hasta que se enumera la última ventana secundaria o la función de devolución de llamada devuelve FALSE.

Sintaxis

BOOL EnumChildWindows(
  [in, optional] HWND        hWndParent,
  [in]           WNDENUMPROC lpEnumFunc,
  [in]           LPARAM      lParam
);

Parámetros

[in, optional] hWndParent

Tipo: HWND

Identificador de la ventana primaria cuyas ventanas secundarias se van a enumerar. Si este parámetro es NULL, esta función equivale a EnumWindows.

[in] lpEnumFunc

Tipo: WNDENUMPROC

Puntero a una función de devolución de llamada definida por la aplicación. Para obtener más información, vea EnumChildProc.

[in] lParam

Tipo: LPARAM

Valor definido por la aplicación que se va a pasar a la función de devolución de llamada.

Valor devuelto

Tipo: BOOL

En esta función, no se usa el valor devuelto.

Comentarios

Si una ventana secundaria ha creado ventanas secundarias propias, EnumChildWindows también enumera esas ventanas.

Se enumerará correctamente una ventana secundaria que se mueve o se cambia de posición en el orden Z durante el proceso de enumeración. La función no enumera una ventana secundaria que se destruye antes de enumerarse o que se crea durante el proceso de enumeración.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)