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

Consulte también

WTSOpenServer