EN
Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.

IMsTscNonScriptable interface

Contains properties and methods that relate to application of a password to the Remote Desktop ActiveX control.

The main use of the IMsTscNonScriptable interface is to configure automatic password logon access to Remote Desktop Session Host (RD Session Host) servers in scenarios where the Remote Desktop ActiveX control is hosted in a custom-written container. When automatic logon is configured, the user does not receive the Windows Logon dialog box at connection time.

On some platforms, the methods of the IMsTscNonScriptable interface can be used to specify passwords in one of three supported formats:

  • Plaintext
  • Portable encoded
  • Binary (nonportable) encoded

Note that a password in an encoded format consists of two parts:

  • Encoded password part.
  • Salt value part.
Both parts are required to set an encoded password. Neither the encoded password part nor the salt value part should be considered securely encrypted.

Scriptable access to plaintext passwords is available through the ClearTextPassword property of the scriptable interface IMsRdpClientAdvancedSettings.

The IMsTscNonScriptable interface can be accessed only through the vtable.

Members

The IMsTscNonScriptable interface inherits from the IUnknown interface. IMsTscNonScriptable also has these types of members:

Methods

The IMsTscNonScriptable interface has these methods.

MethodDescription
ResetPassword

Resets all password states in the control.

 

Properties

The IMsTscNonScriptable interface has these properties.

PropertyAccess typeDescription

BinaryPassword

Read/write

The password part of a binary encoded password.

BinarySalt

Read/write

The salt value part of a binary encoded password.

ClearTextPassword

Write-only

The Remote Desktop ActiveX control password, in plaintext format.

PortablePassword

Read/write

The password part of a portable encoded password.

PortableSalt

Read/write

The salt value part of a portable encoded password.

 

Remarks

Providing a password to the Remote Desktop ActiveX control is optional. If you provide a password to the control, you should apply only one of the preceding three formats to the control before initiating the connection with a call to the Connect method.

Note  You can also enable automatic logon at the server with the Remote Desktop Services configuration tool (Tscc.msc.) An administrator can use this tool to assign a specific password to a connection in a situation where an automated logon is necessary.

For more information about Remote Desktop Web Connection, see Requirements for Remote Desktop Web Connection.

The IMsTscNonScriptable interface has been extended by the following interfaces, with each new interface inheriting all the methods and properties of the previous interfaces:

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Type library

Mstscax.dll

DLL

Mstscax.dll

See also

Remote Desktop Web Connection Reference
IMsTscAx::Connect

 

 

Anzeigen:
© 2014 Microsoft