Función EnumDesktopWindows (winuser.h)

Artículo
08/27/2023

Enumera todas las ventanas de nivel superior asociadas al escritorio especificado. Pasa el identificador a cada ventana, a su vez, a una función de devolución de llamada definida por la aplicación.

Sintaxis

BOOL EnumDesktopWindows(
  [in, optional] HDESK       hDesktop,
  [in]           WNDENUMPROC lpfn,
  [in]           LPARAM      lParam
);

Parámetros

[in, optional] hDesktop

Identificador del escritorio cuyas ventanas de nivel superior se van a enumerar. La función CreateDesktop, GetThreadDesktop, OpenDesktop o OpenInputDesktop devuelve este identificador y debe tener el derecho de acceso DESKTOP_READOBJECTS . Para obtener más información, consulte Derechos de acceso y seguridad de escritorio.

Si este parámetro es NULL, se usa el escritorio actual.

[in] lpfn

Puntero a una función de devolución de llamada EnumWindowsProc definida por la aplicación.

[in] lParam

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

Valor devuelto

Si se produce un error en la función o no puede realizar la enumeración, el valor devuelto es cero.

Para obtener información de error extendida, llame a GetLastError.

Debe asegurarse de que la función de devolución de llamada establece SetLastError si se produce un error.

Windows Server 2003 y Windows XP/2000: Si no hay ventanas en el escritorio, GetLastError devuelve ERROR_INVALID_HANDLE.

Comentarios

La función EnumDesktopWindows invoca repetidamente la función de devolución de llamada lpfn hasta que se enumera la última ventana de nivel superior o la función de devolución de llamada devuelve FALSE.

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-windowstation-l1-1-0 (introducido en Windows 8)