IMsTscNonScriptable (Windows Embedded CE 6.0)
1/6/2010
This interface includes properties and methods that relate to applying a password to the Remote Desktop ActiveX control.
Methods
The IMsTscNonScriptable interface can be accessed only through the virtual function table.
The IMsTscNonScriptable interface contains the following methods:
- IUnknown methods
- IMsTscNonScriptable methods
The following table shows the methods for the IMsTscNonScriptable interface in vtable order.
| Method | Description |
|---|---|
Sets the Remote Desktop ActiveX control password in clear-text format. |
|
Sets the password part of a portable encoded password. |
|
Retrieves the password part of a portable encoded password. This part should not be considered securely encrypted. |
|
Sets the salt value part of a portable encoded password. |
|
Retrieves the salt value part of a portable encoded password. This part should not be considered securely encrypted. |
|
Sets the password part of a binary encoded password. |
|
Retrieves the password part of a binary encoded password. This part should not be considered securely encrypted. |
|
Sets the salt value part of a binary encoded password. |
|
Retrieves the salt value part of a binary encoded password. This part should not be considered securely encrypted. |
|
Resets all password states in the control. |
Remarks
The principal use of the IMsTscNonScriptable interface is to configure automatic password logon access to terminal servers in situations where the Remote Desktop ActiveX control is hosted in a custom-written container. When automatic logon is configured, the Windows logon dialog box is not displayed at connection time. These methods are also available through the IMsRdpClientNonScriptable interface.
You can use the methods of the IMsTscNonScriptable interface to specify a password in one of three supported formats.
- Clear text format
- Portable encoded format
- Binary (nonportable) encoded format
A password that is in encoded format consists of two parts: an encoded password and a salt value. Both are required to set an encoded password. Neither the encoded password nor the salt value should be considered securely encrypted.
You can also use the methods of the IMsTscNonScriptable interface to convert passwords from clear-text format to encoded password format. For more information, see IMsTscNonScriptable::put_ClearTextPassword.
Providing a password to the Remote Desktop ActiveX control is optional. If you provide a password, you should apply a password in one of the three supported formats to the ActiveX control before initiating the connection with a call to IMsTscAx::Connect. Because the IMsRdpClient interface derives from the IMsTscAx interface, you can also call the Connect method of IMsRdpClient to initiate the connection.
Note
You can also enable automatic logon at the server with the Terminal Services configuration tool (Tscc.msc.) An administrator can use this tool to assign a password when automated logon is necessary.
Requirements
| Header | discodlg.h, mstsax.idl |
| Library | Mstsax.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |