IMsTscNonScriptable::ClearTextPassword (Eigenschaft)

Legt das Remotedesktop ActiveX-Steuerelementkennwort im Klartextformat fest.

Diese Eigenschaft ist lesegeschützt.

Syntax

HRESULT put_ClearTextPassword(
  [in] BSTR newClearTextPass
);

Eigenschaftswert

Das Kennwort, das zum Herstellen einer Verbindung verwendet werden soll, angegeben im Klartextformat.

Fehlercodes

Geben Sie S _ OK zurück, wenn erfolgreich.

Hinweise

Das Kennwort wird im sicher verschlüsselten RDP-Kommunikationskanal an den Server übergeben. Nachdem ein Klartextkennwort festgelegt wurde, kann es nicht mehr im Klartextformat abgerufen werden.

Die ClearTextPassword-Eigenschaft kann nur festgelegt werden, wenn sich Remotedesktop ActiveX Steuerelement nicht im verbundenen Zustand befindet. Das Festlegen dieser Eigenschaft schlägt fehl, wenn das Steuerelement verbunden ist. Um den verbundenen Zustand zu überprüfen, rufen Sie die IMsTscAx::Connected-Eigenschaft ab.

Sie können diese Methode auch aufrufen, um ein Klartextkennwort festzusetzen, bevor Sie es entweder in ein portierbares codiertes Kennwort oder in ein binäres (nicht portierbares) codiertes Kennwort konvertieren. Beachten Sie jedoch, dass codierte Kennwörter nicht als sicher verschlüsselt betrachtet werden sollten.

Wenn Sie diese Methode zuerst aufrufen, um ein Kennwort im Klartextformat festlegen, können Sie das Kennwort in ein codiertes Format konvertieren.

So konvertieren Sie ein Klartextkennwort in ein codiertes Format

  1. Legen Sie das Kennwort in der ClearTextPassword-Eigenschaft im Klartextformat fest.
  2. Um das Kennwort im binären (nicht portierbaren) codierten Format abzurufen, rufen Sie die BinaryPassword-Eigenschaft und die BinarySalt-Eigenschaften ab. Sowohl der codierte Kennwortteil als auch der Salt-Teil sind erforderlich, um ein Kennwort im binär codierten Format festlegen zu können.
  3. Rufen Sie zum Abrufen des Kennworts im portierbaren codierten Format die PortablePassword-Methode und die PortableSalt-Eigenschaften ab. Beide Teile sind erforderlich, um ein Kennwort im portierbaren codierten Format festlegen zu können.

Nach dem Ausführen der vorherigen drei Schritte können Sie das Kennwort im codierten Format festlegen, indem Sie die Eigenschaften BinaryPassword und BinarySalt oder PortablePassword und PortableSalt festlegen. Beide Teile sind erforderlich.

Um die automatische Anmeldung zu aktivieren, müssen Sie auch die Eigenschaften UserName und Domain festlegen. Wenn das Kennwort den Benutzer nicht authentifizieren kann, wird auf dem Server Windows Dialogfeld Anmeldung angezeigt, um den Benutzer zur Eingabe des Kennworts aufforderungen.

Weitere Informationen zu Remotedesktop-Webverbindung finden Sie unter Anforderungen für Remotedesktop-Webverbindung.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Typbibliothek
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID _ IMsTscNonScriptable ist als c1e6743a-41c1-4a74-832a-0dd06c1c7a0e definiert.

Siehe auch

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable