Funzione EnumDesktopWindows (winuser.h)
Enumera tutte le finestre di primo livello associate al desktop specificato. Passa l'handle a ogni finestra, a sua volta, a una funzione di callback definita dall'applicazione.
Sintassi
BOOL EnumDesktopWindows(
[in, optional] HDESK hDesktop,
[in] WNDENUMPROC lpfn,
[in] LPARAM lParam
);
Parametri
[in, optional] hDesktop
Handle sul desktop le cui finestre di primo livello devono essere enumerate. Questo handle viene restituito dalla funzione CreateDesktop, GetThreadDesktop, OpenDesktop o OpenInputDesktop e deve avere il diritto di accesso DESKTOP_READOBJECTS. Per altre informazioni, vedere Sicurezza desktop e diritti di accesso.
Se questo parametro è NULL, viene usato il desktop corrente.
[in] lpfn
Puntatore a una funzione di callback EnumWindowsProc definita dall'applicazione.
[in] lParam
Valore definito dall'applicazione da passare alla funzione di callback.
Valore restituito
Se la funzione ha esito negativo o non è in grado di eseguire l'enumerazione, il valore restituito è zero.
Per informazioni dettagliate sull'errore, chiamare GetLastError.
È necessario assicurarsi che la funzione di callback imposta SetLastError se ha esito negativo.
Windows Server 2003 e Windows XP/2000: Se non sono presenti finestre sul desktop, GetLastError restituisce ERROR_INVALID_HANDLE.
Commenti
La funzione EnumDesktopWindows richiama ripetutamente la funzione di callback lpfn fino all'enumerazione dell'ultima finestra di primo livello o la funzione di callback restituisce FALSE.
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-windowstation-l1-1-0 (introdotta in Windows 8) |