Share via


IMsTscAx::Connect

This method initiates a connection using the properties currently set on the control.

HRESULT Connect();

Parameters

None.

Return Values

The following table shows the return values for this method.

Value Description
S_OK Connection was correctly initiated.
E_FAIL The control is already connected or in the connecting state.
nonzero error code An error occurred.

Remarks

The only required property is the server name. For more information, refer to the IMsTscAx::put_Server method.

The control connects asynchronously, therefore 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).

Once Connect has been called, most control properties cannot be set until the control returns to the disconnected state.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Discodlg.h. Mstsax.idl.
Link Library: Mstsax.lib.

See Also

IMsTscAx | IMsTscAx::Disconnect

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.