IMsRdpClientAdvancedSettings6::ConnectToAdministerServer property

Applies to: desktop apps only

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, Windows Vista with Service Pack 1 (SP1), and Windows XP with Service Pack 3 (SP3).

When connecting to a server that is running a version of Windows Server 2008, 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

See also

IMsRdpClientAdvancedSettings6

Send comments about this topic to Microsoft

Build date: 3/7/2012