Funzione EnumDesktopWindows (winuser.h)

Articolo
03/04/2024

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)