WTSWaitSystemEvent 函数 (wtsapi32.h)

在返回到调用方之前,等待远程桌面服务事件。

语法

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

参数

[in] hServer

RD 会话主机服务器的句柄。 指定 由 WTSOpenServer 函数打开的句柄,或指定WTS_CURRENT_SERVER_HANDLE以指示运行应用程序的 RD 会话主机服务器。

[in] EventMask

指定要等待的事件集的位掩码。 可以WTS_EVENT_FLUSH此掩码,导致指定 RD 会话主机服务器句柄上所有挂起的 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_FLUSHWTSWaitSystemEvent 调用而终止等待,则可以 WTS_EVENT_NONE

返回值

如果函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wtsapi32.h
Library Wtsapi32.lib
DLL Wtsapi32.dll

另请参阅

WTSOpenServer