共用方式為


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

另請參閱

WTSOpenServer