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_FLUSH 的 WTSWaitSystemEvent 调用而终止等待,则可以 WTS_EVENT_NONE。
返回值
如果函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | wtsapi32.h |
Library | Wtsapi32.lib |
DLL | Wtsapi32.dll |