Funzione WTSWaitSystemEvent (wtsapi32.h)

  • Articolo

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

Vedi anche

WTSOpenServer