Funzione EnumDesktopsA (winuser.h)
Enumera tutti i desktop associati alla stazione finestra specificata del processo chiamante. La funzione passa il nome di ogni desktop, a sua volta, a una funzione di callback definita dall'applicazione.
Sintassi
BOOL EnumDesktopsA(
[in, optional] HWINSTA hwinsta,
[in] DESKTOPENUMPROCA lpEnumFunc,
[in] LPARAM lParam
);
Parametri
[in, optional] hwinsta
Handle per la stazione finestra i cui desktop devono essere enumerati. Questo handle viene restituito dalla funzione CreateWindowStation, GetProcessWindowStationo funzione OpenWindowStation e deve avere il diritto di accesso WINSTA_ENUMDESKTOPS. Per altre informazioni, vedere Window Station Security and Access Rights.
Se questo parametro è NULL, viene utilizzata la stazione della finestra corrente.
[in] lpEnumFunc
Puntatore a un definito dall'applicazione EnumDesktopProc funzione di callback.
[in] lParam
Valore definito dall'applicazione da passare alla funzione di callback.
Valore restituito
Se la funzione ha esito positivo, restituisce il valore diverso da zero restituito dalla funzione di callback a cui punta lpEnumFunc.
Se la funzione non è in grado di eseguire l'enumerazione, il valore restituito è zero. Chiamare GetLastError per ottenere informazioni estese sull'errore.
Se la funzione di callback ha esito negativo, il valore restituito è zero. La funzione di callback può chiamare SetLastError per impostare un codice di errore da recuperare dal chiamante chiamando GetLastError.
Osservazioni
La funzione EnumDesktops enumera solo i desktop per i quali il processo chiamante ha il diritto di accesso DESKTOP_ENUMERATE. Per altre informazioni, vedere Desktop Security and Access Rights.
La funzione EnumDesktops richiama ripetutamente la funzione di callback lpEnumFunc finché l'ultimo desktop non viene enumerato o la funzione di callback restituisce FALSE.
Nota
L'intestazione winuser.h definisce EnumDesktops come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 2000 Professional [solo app desktop] |
| server minimo supportato | Windows 2000 Server [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
winuser.h (include Windows.h) |
| libreria |
User32.lib |
| dll | User32.dll |
Vedere anche
desktop