IMsTscNonScriptable::ClearTextPassword プロパティ

リモート デスクトップ ActiveX コントロールのパスワードをプレーンテキスト形式で設定します。

このプロパティは書き込み専用です。

構文

HRESULT put_ClearTextPassword(
  [in] BSTR newClearTextPass
);

プロパティ値

プレーンテキスト形式で指定された、接続に使用するパスワード。

エラー コード

成功 した場合はS_OK を返します。

解説

パスワードは、安全に暗号化された RDP 通信チャネルのサーバーに渡されます。 プレーンテキスト パスワードを設定した後は、プレーンテキスト形式で取得できません。

ClearTextPassword プロパティは、リモート デスクトップ ActiveX コントロールが接続状態でない場合にのみ設定できます。 コントロールが接続されている場合、このプロパティの設定は失敗します。 接続状態をチェックするには、IMsTscAx::Connected プロパティを取得します。

また、このメソッドを呼び出してプレーンテキスト パスワードを設定してから、移植可能なエンコードされたパスワードまたはバイナリ (移植不可) でエンコードされたパスワードに変換することもできます。 ただし、エンコードされたパスワードは安全に暗号化されていると見なすべきではありません。

このメソッドを最初に呼び出してプレーンテキスト形式でパスワードを設定する場合は、パスワードをエンコードされた形式に変換できます。

プレーンテキスト パスワードをエンコード形式に変換するには

1. ClearTextPassword プロパティで、パスワードをプレーンテキスト形式で設定します。
2. バイナリ (ポート不可) でエンコードされた形式でパスワードを取得するには、 BinaryPassword プロパティと BinarySalt プロパティを取得します。 バイナリ エンコード形式でパスワードを設定するには、エンコードされたパスワード部分と salt 部分の両方が必要です。
3. ポータブル エンコード形式でパスワードを取得するには、 PortablePassword メソッドと PortableSalt プロパティを取得します。 移植可能なエンコード形式でパスワードを設定するには、両方の部分が必要です。

上記の 3 つの手順に従った後、 BinaryPassword プロパティと BinarySalt プロパティ、または PortablePassword プロパティと PortableSalt プロパティを設定することで、エンコードされた形式でパスワードを設定できます。 両方の部分が必要です。

自動ログオンを有効にするには、 UserName プロパティと Domain プロパティも設定する必要があります。 パスワードがユーザーの認証に失敗した場合は、サーバーに [Windows ログオン] ダイアログ ボックスが表示され、ユーザーにパスワードの入力を求められます。

リモート デスクトップ Web 接続の詳細については、「リモート デスクトップ Web 接続 の要件」を参照してください。

必要条件

関連項目

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable