Función WTSWaitSystemEvent (wtsapi32.h)
Espera un evento de Servicios de Escritorio remoto antes de volver al autor de la llamada.
Sintaxis
BOOL WTSWaitSystemEvent(
[in] HANDLE hServer,
[in] DWORD EventMask,
[out] DWORD *pEventFlags
);
Parámetros
[in] hServer
Identificador de un servidor host de sesión de Escritorio remoto. Especifique un identificador abierto por la función WTSOpenServer o especifique WTS_CURRENT_SERVER_HANDLE para indicar el servidor host de sesión de Escritorio remoto en el que se ejecuta la aplicación.
[in] EventMask
Máscara de bits que especifica el conjunto de eventos que se van a esperar. Esta máscara puede ser WTS_EVENT_FLUSH hacer que se devuelvan todas las llamadas WTSWaitSystemEvent pendientes en el identificador de host de sesión de Escritorio remoto especificado. O bien, la máscara puede ser una combinación de los valores siguientes.
WTS_EVENT_ALL
Espere a cualquier tipo de evento.
WTS_EVENT_CONNECT
Un cliente conectado a winStation.
WTS_EVENT_CREATE
Se creó una nueva WinStation.
WTS_EVENT_DELETE
Se eliminó una winStation existente.
WTS_EVENT_DISCONNECT
Un cliente desconectado de winStation.
WTS_EVENT_LICENSE
El estado de licencia de Servicios de Escritorio remoto ha cambiado. Esto ocurre cuando se agrega o elimina una licencia mediante el Administrador de licencias.
WTS_EVENT_LOGOFF
Un usuario ha cerrado sesión desde la consola de Servicios de Escritorio remoto o desde un cliente WinStation.
WTS_EVENT_LOGON
Un usuario ha iniciado sesión en el sistema desde la consola de Servicios de Escritorio remoto o desde un cliente WinStation.
WTS_EVENT_RENAME
Se ha cambiado el nombre de una WinStation existente.
WTS_EVENT_STATECHANGE
Ha cambiado el estado de conexión de WinStation. Para obtener una lista de estados de conexión, consulte el WTS_CONNECTSTATE_CLASS tipo de enumeración.
[out] pEventFlags
Puntero a una variable que recibe una máscara de bits del evento o eventos que se produjeron. La máscara devuelta puede ser una combinación de los valores de la lista anterior o puede ser WTS_EVENT_NONE si la espera finaliza debido a una llamada WTSWaitSystemEvent con WTS_EVENT_FLUSH.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | wtsapi32.h |
| Library | Wtsapi32.lib |
| Archivo DLL | Wtsapi32.dll |