Función EnumWindows (winuser.h)

Artículo
03/04/2024

Enumera todas las ventanas de nivel superior de la pantalla pasando el identificador a cada ventana, a su vez, a una función de devolución de llamada definida por la aplicación. EnumWindows continúa hasta que se enumera la última ventana de nivel superior o la función de devolución de llamada devuelve FALSE.

Sintaxis

BOOL EnumWindows(
  [in] WNDENUMPROC lpEnumFunc,
  [in] LPARAM      lParam
);

Parámetros

[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 EnumWindowsProc.

[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

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Si EnumWindowsProc devuelve cero, el valor devuelto también es cero. En este caso, la función de devolución de llamada debe llamar a SetLastError para obtener un código de error significativo que se devolverá al autor de la llamada de EnumWindows.

Comentarios

La función EnumWindows no enumera las ventanas secundarias , con la excepción de algunas ventanas de nivel superior que pertenecen al sistema que tienen el estilo WS_CHILD .

Esta función es más confiable que llamar a la función GetWindow en un bucle. Una aplicación que llama a GetWindow para realizar esta tarea corre el riesgo de detectarse en un bucle infinito o hacer referencia a un identificador a una ventana que se ha destruido.

Nota Para Windows 8 y versiones posteriores, EnumWindows enumera solo las ventanas de nivel superior de las aplicaciones de escritorio.

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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)