Поделиться через


Функция 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.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wtsapi32.h
Библиотека Wtsapi32.lib
DLL Wtsapi32.dll

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

WTSOpenServer