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

Интерфейс IWTSPlugin (tsvirtualchannels.h)

  • Статья

Позволяет загружать подключаемый модуль клиента подключения к удаленному рабочему столу (RDC) клиентом подключения к удаленному рабочему столу ( RDC). Интерфейс реализуется подключаемым модулем и получается клиентом RDC и управляется ими.

Клиент RDC получает экземпляр этого интерфейса либо путем создания экземпляра COM-объекта, либо путем вызова функции VirtualChannelGetInstance , реализованной подключаемым модулем. Дополнительные сведения о получении экземпляров см. в разделе Регистрация подключаемого модуля DVC. Во всех случаях этот экземпляр хранится в течение всего времени существования клиента подключения к удаленному рабочему столу (RDC).

В качестве COM-объекта подключаемый модуль должен быть реализован в модели со свободными потоками. Так как методы IWTSPlugin реализуются подключаемым модулем, подключаемый модуль должен учитывать, что вызов может поступать в разные потоки. Вызовы всегда будут поступать последовательно, поэтому невозможно иметь два вызова, которые выполняются параллельно.

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

Наследование

Интерфейс IWTSPlugin наследуется от интерфейса IUnknown . IWTSPlugin также имеет следующие типы членов:

Методы

Интерфейс IWTSPlugin имеет следующие методы.

 
IWTSPlugin::Connected

Уведомляет подключаемый модуль о том, что клиент подключения к удаленному рабочему столу (RDC) успешно подключен к серверу узла сеансов удаленных рабочих столов ( узел сеансов удаленных рабочих столов).
IWTSPlugin::D подключение

Уведомляет подключаемый модуль о том, что клиент подключения к удаленному рабочему столу (RDC) отключился от сервера узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов).
IWTSPlugin::Initialize

Используется для первого вызова подключаемого модуля из клиента.
IWTSPlugin::Terminated

Уведомляет подключаемый модуль о том, что клиент подключения к удаленному рабочему столу (RDC) завершил работу.

Комментарии

Интерфейс IWTSPlugin реализуется %System32%\webauthn.dll для включения функции перенаправления WebAuthn удаленного рабочего стола. Получите экземпляр этого интерфейса, вызвав VirtualChannelGetInstance, который также предоставляется webauthn.dll.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header tsvirtualchannels.h