Funzione EnumWindowStationsA (winuser.h)
Enumera tutte le stazioni finestra nella sessione corrente. La funzione passa il nome di ogni stazione finestra, a sua volta, a una funzione di callback definita dall'applicazione.
Sintassi
BOOL EnumWindowStationsA(
[in] WINSTAENUMPROCA lpEnumFunc,
[in] LPARAM lParam
);
Parametri
[in] lpEnumFunc
Puntatore a un definito dall'applicazione EnumWindowStationProc 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 EnumWindowStations enumera solo le stazioni finestra per le quali il processo chiamante ha il diritto di accesso WINSTA_ENUMERATE. Per altre informazioni, vedere Window Station Security and Access Rights.
EnumWindowStations richiama ripetutamente la funzione di callback lpEnumFunc finché l'ultima stazione della finestra non viene enumerata o la funzione di callback restituisce FALSE.
Nota
L'intestazione winuser.h definisce EnumWindowStations 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 |