Функция WTSDisconnectSession (wtsapi32.h)

Статья
03/09/2024

Отключает пользователя, выполнившего вход, от указанного сеанса служб удаленных рабочих столов без закрытия сеанса. Если пользователь впоследствии входит на тот же сервер узла сеансов удаленных рабочих столов (узел сеансов удаленных рабочих столов), он повторно подключается к тому же сеансу.

Синтаксис

BOOL WTSDisconnectSession(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] BOOL   bWait
);

Параметры

[in] hServer

Дескриптор сервера узла сеансов удаленных рабочих стола. Укажите дескриптор, открытый функцией WTSOpenServer или WTSOpenServerEx , или укажите WTS_CURRENT_SERVER_HANDLE , чтобы указать сервер узла сеансов удаленных рабочих столов, на котором выполняется приложение.

[in] SessionId

Идентификатор сеанса Служб удаленных рабочих столов. Чтобы указать текущий сеанс, укажите WTS_CURRENT_SESSION. Чтобы получить идентификаторы всех сеансов на указанном сервере узла сеансов удаленных рабочих столов, используйте функцию WTSEnumerateSessions .

Чтобы отключить сеанс другого пользователя, необходимо иметь разрешение Отключить. Дополнительные сведения см. в разделе Разрешения служб удаленных рабочих столов. Чтобы изменить разрешения для сеанса, используйте средство администрирования Конфигурации служб удаленных рабочих столов.

Чтобы отключить сеансы, выполняемые на виртуальной машине, размещенной на сервере узла виртуализации удаленных рабочих машин, необходимо быть членом группы администраторов на сервере узла виртуализации удаленных рабочих машин.

[in] bWait

Указывает, является ли операция синхронной. Укажите значение TRUE , чтобы дождаться завершения операции, или значение FALSE для немедленного возврата.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wtsapi32.h
Библиотека	Wtsapi32.lib
DLL	Wtsapi32.dll
Набор API	ext-ms-win-session-wtsapi32-l1-1-0 (представлено в Windows 8)

См. также раздел

WTSEnumerateSessions

Поделиться через