遠端桌面服務管理

遠端桌面服務 API 可讓您列舉和管理遠端桌面工作階段主機 (RD 工作階段主機) 伺服器、用戶端會話和進程。

若要擷取網域中所有 RD 工作階段主機伺服器的名稱,請呼叫 NetServerEnum 函式來列舉SV_TYPE_TERMINALSERVER類型的伺服器。 若要開啟特定 RD 工作階段主機伺服器的控制碼,請在呼叫 WTSOpenServer 函式中傳遞伺服器名稱。 當您完成使用控制碼時,請呼叫 WTSCloseServer 函式來釋放它。

您可以使用 WTSOpenServer 傳回的控制碼,在伺服器上執行下列作業。

函式 作業
WTSDisconnectSession 中斷用戶端與指定會話的連線。 會話會保持作用中,而且使用者可以再次登入以連線到相同的會話。
WTSEnumerateSessions 傳回指定 RD 工作階段主機伺服器上的會話清單。
WTSEnumerateProcesses 傳回指定 RD 工作階段主機伺服器上的進程清單。
WTSLogoffSession 登出指定的會話。
WTSQuerySessionInformation 傳回指定 RD 工作階段主機伺服器上的指定會話相關資訊。
WTSSendMessage 在用戶端上顯示指定會話的訊息方塊。
WTSShutdownSystem 關閉並選擇性地重新開機指定的 RD 工作階段主機伺服器。
WTSTerminateProcess 終止指定 RD 工作階段主機伺服器上的指定進程。
WTSVirtualChannelOpen 開啟指定之虛擬通道之伺服器端的控制碼。 如需虛擬通道的詳細資訊,請參閱 使用遠端桌面服務虛擬通道
WTSWaitSystemEvent 等候事件,例如建立用戶端會話或使用者登入 RD 工作階段主機伺服器。

 

其中數個函式會配置緩衝區,以將資訊傳回給呼叫端。 當您完成使用緩衝區時,請呼叫 WTSFreeMemory 函式 來釋放緩衝區。