Applies to: desktop apps only
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.
| Method | Description |
|---|
|
ResetPassword
|
Resets all password states in the control.
|
Properties
The IMsTscNonScriptable interface has these properties.
| Property | Access type | Description |
|---|
|
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 2000 Professional |
|---|
|
Minimum supported server
| Windows 2000 Server |
|---|
See also
-
Remote Desktop Web Connection Reference
-
IMsTscAx::Connect
Send comments about this topic to Microsoft
Build date: 3/7/2012