Функция WTSWaitSystemEvent (wtsapi32.h)

Ожидает события служб удаленных рабочих столов перед возвращением вызывающей стороны.

Синтаксис

BOOL WTSWaitSystemEvent(
  [in]  HANDLE hServer,
  [in]  DWORD  EventMask,
  [out] DWORD  *pEventFlags
);

Параметры

[in] hServer

Обработка на сервере узла сеансов удаленных рабочих стола. Укажите дескриптор, открытый функцией WTSOpenServer , или укажите WTS_CURRENT_SERVER_HANDLE, чтобы указать сервер узла сеансов удаленных рабочих столов, на котором выполняется приложение.

[in] EventMask

Битовая маска, задающая набор событий для ожидания. Эту маску можно WTS_EVENT_FLUSH, чтобы вызвать возврат всех ожидающих вызовов WTSWaitSystemEvent указанного дескриптора сервера узла сеансов удаленных рабочих стола. Кроме того, маска может быть комбинацией следующих значений.

WTS_EVENT_ALL

Дождитесь любого типа события.

WTS_EVENT_CONNECT

Клиент, подключенный к WinStation.

WTS_EVENT_CREATE

Была создана новая платформа WinStation.

WTS_EVENT_DELETE

Удалена существующая платформа WinStation.

WTS_EVENT_DISCONNECT

Клиент, отключенный от WinStation.

WTS_EVENT_LICENSE

Состояние лицензии Служб удаленных рабочих столов изменилось. Это происходит при добавлении или удалении лицензии с помощью диспетчера лицензий.

WTS_EVENT_LOGOFF

Пользователь выполнил выход из консоли служб удаленных рабочих столов или клиента WinStation.

WTS_EVENT_LOGON

Пользователь вошел в систему из консоли служб удаленных рабочих столов или клиента WinStation.

WTS_EVENT_RENAME

Существующая платформа WinStation была переименована.

WTS_EVENT_STATECHANGE

Изменено состояние подключения WinStation. Список состояний подключения см. в разделе Тип перечисления WTS_CONNECTSTATE_CLASS .

[out] pEventFlags

Указатель на переменную, получающую битовую маску события или произошедших событий. Возвращаемая маска может быть сочетанием значений из предыдущего списка или WTS_EVENT_NONE , если ожидание завершилось из-за вызова WTSWaitSystemEvent с WTS_EVENT_FLUSH.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

См. также раздел

WTSOpenServer