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, im Klartextformat angegeben.

Fehlercodes

Gibt bei erfolgreicher Ausführung S_OK zurück.

Bemerkungen

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 das ActiveX-Remotedesktopsteuerelement nicht im Zustand verbunden befindet. Das Festlegen dieser Eigenschaft schlägt fehl, wenn das Steuerelement verbunden ist. Um den Verbindungsstatus zu überprüfen, rufen Sie die IMsTscAx::Connected-Eigenschaft ab.

Sie können diese Methode auch aufrufen, um ein Klartextkennwort festzulegen, bevor Sie es entweder in ein portables 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 zum ersten Mal aufrufen, um ein Kennwort im Klartextformat festzulegen, können Sie das Kennwort dann in das codierte Format konvertieren.

So konvertieren Sie ein Klartextkennwort in ein codiertes Format

1. Legen Sie das Kennwort im Klartextformat in der ClearTextPassword-Eigenschaft 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 festzulegen.
3. Um das Kennwort im portablen codierten Format abzurufen, rufen Sie die PortablePassword-Methode und die PortableSalt-Eigenschaften ab. Beide Teile sind erforderlich, um ein Kennwort im portablen codierten Format festzulegen.

Nachdem Sie die vorherigen drei Schritte ausgeführt haben, 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 authentifiziert, wird das Dialogfeld Windows-Anmeldung auf dem Server angezeigt, um den Benutzer zur Eingabe des Kennworts aufzufordern.

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

Anforderungen

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

Siehe auch

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable