Администрирование служб удаленных рабочих столов
API служб удаленных рабочих столов позволяет перечислять серверы, клиентские сеансы и процессы узла сеансов удаленных рабочих столов и управлять ими.
Чтобы получить имена всех серверов узлов сеансов удаленных рабочих столов в домене, вызовите функцию NetServerEnum для перечисления серверов типа SV_TYPE_TERMINALSERVER. Чтобы открыть дескриптор для определенного сервера узла сеансов удаленных рабочих столов, передайте имя сервера в вызове функции WTSOpenServer . Завершив использование дескриптора, отпустите его, вызвав функцию WTSCloseServer .
Для выполнения следующих операций на сервере можно использовать дескриптор, возвращаемый WTSOpenServer .
Функция | Операция |
---|---|
WTSDisconnectSession | Отключает клиент от указанного сеанса. Сеанс остается активным, и пользователь может снова войти в систему, чтобы подключиться к тому же сеансу. |
WTSEnumerateSessions | Возвращает список сеансов на указанном сервере узла сеансов удаленных рабочих стола. |
WTSEnumerateProcesses | Возвращает список процессов на указанном сервере узла сеансов удаленных рабочих стола. |
WTSLogoffSession | Выход из указанного сеанса. |
WTSQuerySessionInformation | Возвращает сведения об указанном сеансе на указанном сервере узла сеансов удаленных рабочих стола. |
WTSSendMessage | Отображает окно сообщения на клиентском отображении указанного сеанса. |
WTSShutdownSystem | Завершает работу и при необходимости перезапускает указанный сервер узла сеансов удаленных рабочих стола. |
WTSTerminateProcess | Завершает указанный процесс на указанном сервере узла сеансов удаленных рабочих стола. |
WTSVirtualChannelOpen | Открывает дескриптор для серверного конца указанного виртуального канала. Дополнительные сведения о виртуальных каналах см. в статье Использование виртуальных каналов служб удаленных рабочих столов. |
WTSWaitSystemEvent | Ожидает события, например создания сеанса клиента или входа пользователя на сервер узла сеансов удаленных рабочих стола. |
Некоторые из этих функций выделяют буферы для возврата информации вызывающей объекту. Завершив использование буфера, освободите его, вызвав функцию WTSFreeMemory .