IMsTscSecuredSettings (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

get_StartProgram

Retrieves the value of the StartProgram property, which specifies the program to be started on the Terminal Server upon connection.

get_WorkDir

Retrieves the WorkDir property, which specifies the current working directory of the start program specified by the value of the StartProgram property.

put_StartProgram

Sets the value of the StartProgram property, which specifies the program to be started on the Terminal Server upon connection.

put_WorkDir

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

See Also

Concepts

Remote Desktop ActiveX Control Interfaces