Edit

IMsRdpClientAdvancedSettings6::ConnectToAdministerServer property

  • Article

Retrieves or specifies whether the ActiveX control should attempt to connect to the server for administrative purposes.

This property is read/write.

Syntax

HRESULT put_ConnectToAdministerServer(
  [in]  VARIANT_BOOL connectToAdministerServer
);

HRESULT get_ConnectToAdministerServer(
  [out] VARIANT_BOOL *pConnectToAdministerServer
);

Property value

VARIANT_TRUE to cause the ActiveX control to attempt to connect to the server for administrative purposes; otherwise VARIANT_FALSE. The default value is VARIANT_FALSE.

Remarks

To use ConnectToAdministerServer, you must be running Remote Desktop Connection (RDC) client version 6.1 or later.

Note

RDC version 6.1 (6.0.6001) supports Remote Desktop Protocol 6.1. RDC 6.1 is included with Windows Server 2008 and Windows Vista with Service Pack 1 (SP1).

ConnectToAdministerServer connects you to a session that is used for administrative purposes on the remote server. If the Remote Desktop Session Host (RD Session Host) role service is installed on the remote server, ConnectToAdministerServer does the following:

  • Disables Remote Desktop Services client access licensing for the session.
  • Disables time zone redirection for the session.
  • Disables Remote Desktop Connection Broker (RD Connection Broker) redirection for the session.
  • Disables Plug and Play device redirection for the session.
  • Changes the remote session theme to Windows Classic for the session.

Requirements

Requirement Value
Minimum supported client
 Windows Vista
Minimum supported server
 Windows Server 2008
Type library
MsTscAx.dll
DLL
MsTscAx.dll
IID
 IID_IMsRdpClientAdvancedSettings6 is defined as 222c4b5d-45d9-4df0-a7c6-60cf9089d285

See also

IMsRdpClientAdvancedSettings7

IMsRdpClientAdvancedSettings8

IMsRdpClientAdvancedSettings6