IMsTscAx::Connect method

Initiates a connection using the properties currently set on the control.

Syntax

HRESULT Connect();

Parameters

This method has no parameters.

Return value

Return S_OK if successful.

Remarks

The only required property is the server name. Refer to the Server property.

The control connects asynchronously, so a return from a Connect call indicates only that the connection has been initiated successfully, not that it has been completed. You should respond to events on the IMsTscAxEvents interface to determine when the control has successfully connected (or has been disconnected.)

This method returns E_FAIL if it is called while the control is already connected or in the connecting state.

After Connect has been called, most of the control properties can no longer be set until the control returns to the disconnected state.

For more information about Remote Desktop Web Connection, see Requirements for Remote Desktop Web Connection.

Requirements

Requirement Value
Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Type library
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsTscAx is defined as 8C11EFAE-92C3-11D1-BC1E-00C04FA31489

See also

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

Disconnect

IMsTscAx