Funzione EnumWindowStationsA (winuser.h)

  • Articolo

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 una funzione di callback definita dall'applicazione EnumWindowStationProc .

[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 callback a cui è stato fatto riferimento lpEnumFunc.

Se la funzione non è in grado di eseguire l'enumerazione, il valore restituito è zero. Chiamare GetLastError per ottenere informazioni sull'errore estese.

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 per il chiamante da recuperare chiamando GetLastError.

Commenti

La funzione EnumWindowStations enumera solo quelle stazioni finestra per cui il processo chiamante ha il diritto di accesso WINSTA_ENUMERATE. Per altre informazioni, vedere Diritti di accesso e sicurezza della stazione di finestra.

EnumWindowStations richiama ripetutamente la funzione di callback lpEnumFunc fino all'enumerazione dell'ultima stazione finestra 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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

Vedi anche

EnumWindowStationProc

Funzioni di Window Station e Desktop

Stazioni finestra