Funzione EnumWindows (winuser.h)
Enumera tutte le finestre di primo livello sullo schermo passando l'handle a ogni finestra, a sua volta, a una funzione di callback definita dall'applicazione. EnumWindows continua fino a quando l'ultima finestra di primo livello non viene enumerata o la funzione di callback restituisce FALSE.
Sintassi
BOOL EnumWindows(
[in] WNDENUMPROC lpEnumFunc,
[in] LPARAM lParam
);
Parametri
[in] lpEnumFunc
Tipo: WNDENUMPROC
Puntatore a una funzione di callback definita dall'applicazione. Per altre informazioni, vedere EnumWindowsProc.
[in] lParam
Tipo: LPARAM
Valore definito dall'applicazione da passare alla funzione di callback.
Valore restituito
Tipo: BOOL
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Se EnumWindowsProc restituisce zero, anche il valore restituito è zero. In questo caso, la funzione di callback deve chiamare SetLastError per ottenere un codice di errore significativo da restituire al chiamante di EnumWindows.
Commenti
La funzione EnumWindows non enumera le finestre figlio, ad eccezione di alcune finestre di primo livello di proprietà del sistema con lo stile WS_CHILD .
Questa funzione è più affidabile rispetto alla chiamata della funzione GetWindow in un ciclo. Un'applicazione che chiama GetWindow per eseguire questa attività rischia di essere intercettata in un ciclo infinito o che fa riferimento a un handle a una finestra che è stata eliminata definitivamente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-window-l1-1-0 (introdotto in Windows 8) |
Vedi anche
Informazioni concettuali
Riferimento