Skip to content

Latest commit

 

History

History
140 lines (95 loc) · 4.22 KB

imstscax-connect.md

File metadata and controls

140 lines (95 loc) · 4.22 KB
title description ms.assetid ms.tgt_platform keywords topic_type api_name api_location api_type ms.topic ms.date
IMsTscAx Connect method
Initiates a connection using the properties currently set on the control.
9bcbdc13-6c66-4737-82a4-98329f173743
multiple
Connect method Remote Desktop Services
Connect method Remote Desktop Services , IMsTscAx interface
IMsTscAx interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient interface
IMsRdpClient interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient2 interface
IMsRdpClient2 interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient3 interface
IMsRdpClient3 interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient4 interface
IMsRdpClient4 interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient5 interface
IMsRdpClient5 interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient6 interface
IMsRdpClient6 interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient7 interface
IMsRdpClient7 interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient8 interface
IMsRdpClient8 interface Remote Desktop Services , Connect method
Connect method Remote Desktop Services , IMsRdpClient9 interface
IMsRdpClient9 interface Remote Desktop Services , Connect method
apiref
IMsTscAx.Connect
IMsRdpClient.Connect
IMsRdpClient2.Connect
IMsRdpClient3.Connect
IMsRdpClient4.Connect
IMsRdpClient5.Connect
IMsRdpClient6.Connect
IMsRdpClient7.Connect
IMsRdpClient8.Connect
IMsRdpClient9.Connect
MsTscAx.dll
COM
reference
05/31/2018

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