IMsTscNonScriptable (Windows CE 5.0)
This interface includes properties and methods that relate to application of a password to the Remote Desktop ActiveX control.
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 passwords in one of three supported formats:
- Clear text
- Portable encoded
- Binary (nonportable) encoded
A password 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 an encoded password format. For more information, see IMsTscNonScriptable::put_ClearTextPassword and the following Remarks section.
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 |
|---|---|
| put_ClearTextPassword | Sets the Remote Desktop ActiveX control password in clear-text format. |
| put_PortablePassword | Sets the password part of a portable encoded password. |
| get_PortablePassword | Retrieves the password part of a portable encoded password. This part should not be considered securely encrypted. |
| put_PortableSalt | Sets the salt value part of a portable encoded password. |
| get_PortableSalt | Retrieves the salt value part of a portable encoded password. This part should not be considered securely encrypted. |
| put_BinaryPassword | Sets the password part of a binary encoded password. |
| get_BinaryPassword | Retrieves the password part of a binary encoded password. This part should not be considered securely encrypted. |
| put_BinarySalt | Sets the salt value part of a binary encoded password. |
| get_BinarySalt | Retrieves the salt value part of a binary encoded password. This part should not be considered securely encrypted. |
| ResetPassword | Resets all password states in the control. |
Remarks
Providing a password to the Remote Desktop ActiveX control is optional. If you provide a password, you should apply only one of the preceding three formats to the 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
OS Versions: Windows CE .NET 4.0 and later.
Header: Discodlg.h. Mstsax.idl.
Link Library: Mstsax.lib.
See Also
Remote Desktop ActiveX Control Interface
Send Feedback on this topic to the authors