IMsTscNonScriptable::ClearTextPassword プロパティ
リモート デスクトップ ActiveX コントロールのパスワードをプレーンテキスト形式で設定します。
このプロパティは書き込み専用です。
構文
HRESULT put_ClearTextPassword(
[in] BSTR newClearTextPass
);
プロパティ値
プレーンテキスト形式で指定された、接続に使用するパスワード。
エラー コード
成功 した場合はS_OK を返します。
解説
パスワードは、安全に暗号化された RDP 通信チャネルのサーバーに渡されます。 プレーンテキスト パスワードを設定した後は、プレーンテキスト形式で取得できません。
ClearTextPassword プロパティは、リモート デスクトップ ActiveX コントロールが接続状態でない場合にのみ設定できます。 コントロールが接続されている場合、このプロパティの設定は失敗します。 接続状態をチェックするには、IMsTscAx::Connected プロパティを取得します。
また、このメソッドを呼び出してプレーンテキスト パスワードを設定してから、移植可能なエンコードされたパスワードまたはバイナリ (移植不可) でエンコードされたパスワードに変換することもできます。 ただし、エンコードされたパスワードは安全に暗号化されていると見なすべきではありません。
このメソッドを最初に呼び出してプレーンテキスト形式でパスワードを設定する場合は、パスワードをエンコードされた形式に変換できます。
プレーンテキスト パスワードをエンコード形式に変換するには
- ClearTextPassword プロパティで、パスワードをプレーンテキスト形式で設定します。
- バイナリ (ポート不可) でエンコードされた形式でパスワードを取得するには、 BinaryPassword プロパティと BinarySalt プロパティを取得します。 バイナリ エンコード形式でパスワードを設定するには、エンコードされたパスワード部分と salt 部分の両方が必要です。
- ポータブル エンコード形式でパスワードを取得するには、 PortablePassword メソッドと PortableSalt プロパティを取得します。 移植可能なエンコード形式でパスワードを設定するには、両方の部分が必要です。
上記の 3 つの手順に従った後、 BinaryPassword プロパティと BinarySalt プロパティ、または PortablePassword プロパティと PortableSalt プロパティを設定することで、エンコードされた形式でパスワードを設定できます。 両方の部分が必要です。
自動ログオンを有効にするには、 UserName プロパティと Domain プロパティも設定する必要があります。 パスワードがユーザーの認証に失敗した場合は、サーバーに [Windows ログオン] ダイアログ ボックスが表示され、ユーザーにパスワードの入力を求められます。
リモート デスクトップ Web 接続の詳細については、「リモート デスクトップ Web 接続 の要件」を参照してください。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| タイプ ライブラリ |
|
| [DLL] |
|
| IID |
IID_IMsTscNonScriptableは c1e6743a-41c1-4a74-832a-0dd06c1c7a0e として定義されています |