Condividi tramite


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

Vedere anche

EnumWindowStationProc

funzioni di windows e desktop