Funzione EnumWindows (winuser.h)

Articolo
03/13/2024

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.

Nota Per Windows 8 e versioni successive, EnumWindows enumera solo le finestre di primo livello delle app desktop.

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)