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

Свойство IMsTscNonScriptable::ClearTextPassword

  • Статья

Задает пароль элемента управления ActiveX удаленного рабочего стола в формате открытого текста.

Это свойство доступно только на запись.

Синтаксис

HRESULT put_ClearTextPassword(
  [in] BSTR newClearTextPass
);

Значение свойства

Пароль для подключения, указанный в формате открытого текста.

Коды ошибок

В случае успешного выполнения верните S_OK.

Комментарии

Пароль передается серверу в безопасно зашифрованном канале связи RDP. После установки пароля в виде открытого текста его невозможно получить в формате открытого текста.

Свойство ClearTextPassword можно задать только в том случае, если элемент ActiveX удаленного рабочего стола не находится в подключенном состоянии. Установка этого свойства завершается ошибкой, если элемент управления подключен. Чтобы проверка для подключенного состояния, получите свойство IMsTscAx::Connected.

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

Если сначала вызвать этот метод, чтобы задать пароль в формате открытого текста, можно преобразовать пароль в закодированный формат.

Преобразование открытого пароля в закодированный формат

  1. Задайте пароль в формате открытого текста в свойстве ClearTextPassword .
  2. Чтобы получить пароль в двоичном (непортабельном) формате, получите свойства BinaryPassword и BinarySalt . Для установки пароля в двоичном формате требуется как часть закодированного пароля, так и часть "соль".
  3. Чтобы получить пароль в переносимом закодированном формате, получите метод PortablePassword и свойства PortableSalt . Обе части необходимы для установки пароля в переносимом закодированном формате.

После выполнения предыдущих трех шагов можно задать пароль в закодированном формате, задав свойства BinaryPassword и BinarySalt или PortablePassword и PortableSalt . Обе части являются обязательными.

Чтобы включить автоматический вход, необходимо также задать свойства UserName и Domain . Если пароль не проходит проверку подлинности пользователя, на сервере отображается диалоговое окно Вход в Windows, в котором пользователю будет предложено ввести пароль.

Дополнительные сведения о веб-подключении к удаленному рабочему столу см. в разделе Требования к веб-подключению к удаленному рабочему столу.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Библиотека типов
MsTscAx.dll
DLL
MsTscAx.dll
IID
 IID_IMsTscNonScriptable определяется как c1e6743a-41c1-4a74-832a-0ddd06c1c7a0e

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

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable