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