Función EnumDesktopWindows (winuser.h)
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) |