Funzione WTSWaitSystemEvent (wtsapi32.h)
Attende un evento di Servizi Desktop remoto prima di tornare al chiamante.
Sintassi
BOOL WTSWaitSystemEvent(
[in] HANDLE hServer,
[in] DWORD EventMask,
[out] DWORD *pEventFlags
);
Parametri
[in] hServer
Gestire in un server host sessione Desktop remoto. Specificare un handle aperto dalla funzione WTSOpenServer oppure specificare WTS_CURRENT_SERVER_HANDLE per indicare il server Host sessione Desktop remoto in cui è in esecuzione l'applicazione.
[in] EventMask
Maschera di bit che specifica il set di eventi da attendere. Questa maschera può essere WTS_EVENT_FLUSH per fare in modo che vengano restituite tutte le chiamate WTSWaitSystemEvent in sospeso nell'handle del server host sessione Desktop remoto specificato. In alternativa, la maschera può essere una combinazione dei valori seguenti.
WTS_EVENT_ALL
Attendere qualsiasi tipo di evento.
WTS_EVENT_CONNECT
Un client connesso a una WinStation.
WTS_EVENT_CREATE
È stata creata una nuova WinStation.
WTS_EVENT_DELETE
È stata eliminata una WinStation esistente.
WTS_EVENT_DISCONNECT
Un client disconnesso da una WinStation.
WTS_EVENT_LICENSE
Lo stato della licenza di Servizi Desktop remoto è cambiato. Ciò si verifica quando una licenza viene aggiunta o eliminata usando License Manager.
WTS_EVENT_LOGOFF
Un utente si è disconnesso dalla console di Servizi Desktop remoto o da un client WinStation.
WTS_EVENT_LOGON
Un utente ha eseguito l'accesso al sistema dalla console di Servizi Desktop remoto o da un client WinStation.
WTS_EVENT_RENAME
Una WinStation esistente è stata rinominata.
WTS_EVENT_STATECHANGE
È stato modificato uno stato di connessione WinStation. Per un elenco degli stati di connessione, vedere il tipo di enumerazione WTS_CONNECTSTATE_CLASS .
[out] pEventFlags
Puntatore a una variabile che riceve una maschera di bit dell'evento o degli eventi che si sono verificati. La maschera restituita può essere una combinazione dei valori dell'elenco precedente oppure può essere WTS_EVENT_NONE se l'attesa è terminata a causa di una chiamata WTSWaitSystemEvent con WTS_EVENT_FLUSH.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | wtsapi32.h |
| Libreria | Wtsapi32.lib |
| DLL | Wtsapi32.dll |