IMsTscSecuredSettings
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This interface includes methods to retrieve and set properties of the Remote Desktop ActiveX control that are restricted to specific Internet Explorer security zones. Properties include those that specify the program to start upon connection to the terminal server and that specify the program's working directory.
Methods
The IMsTscSecuredSettings interface provides the following methods:
The following table shows the methods for IMsTscSecuredSettings.
These methods are also available through the IMsRdpClientSecuredSettings interface.
| Method | Description |
|---|---|
Retrieves the value of the StartProgram property, which specifies the program to be started on the Terminal Server upon connection. |
|
Retrieves the WorkDir property, which specifies the current working directory of the start program specified by the value of the StartProgram property. |
|
Sets the value of the StartProgram property, which specifies the program to be started on the Terminal Server upon connection. |
|
Sets the WorkDir property, which specifies the current working directory of the start program specified by the value of the StartProgram property. |
Remarks
To allow clients to protect themselves from potentially untrustworthy servers, some properties of the Remote Desktop ActiveX control object are restricted to specific Internet Explorer URL security zones. This means that, when a user browsing the Web accesses the page and the page is in a higher URL security zone than the computer they are browsing the Web with, these properties are disabled. These restricted properties are accessed using the IMsTscSecuredSettings interface and the IMsRdpClientSecuredSettings interface. These restricted properties are available in the following Internet Explorer URL security zones:
- My Computer
- Local Intranet
- Trusted Sites
These restricted properties are disabled in these zones:
- Internet
- Restricted Sites
If you want to access these restricted properties within your Terminal Services Web application, you should call IMsTscAx::get_SecuredSettings2 to get an IMsTscSecuredSettings interface pointer for accessing the secured settings properties.
The IMsTscSecuredSettings interface accesses the following restricted properties.
- StartProgram. This property specifies the program that will be started upon connection.
- WorkDir. This property specifies the working directory of the program specified in StartProgram.
Requirements
| Header | discodlg.h, mstsax.idl |
| Library | Mstsax.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |