遠端桌面服務管理
遠端桌面服務 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 函式 來釋放緩衝區。