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 |
程式庫 | Wtsapi32.lib |
Dll | Wtsapi32.dll |