ITBasicCallControl::Connect method (tapi3if.h)

The Connect method attempts to complete the connection of an outgoing call.

Syntax

HRESULT Connect(
  VARIANT_BOOL fSync
);

Parameters

fSync

Boolean indicating whether connection is to be performed synchronously (VARIANT_TRUE) or asynchronously (VARIANT_FALSE).

Return value

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
TAPI_E_INVALCALLSTATE

Call state must be CS_IDLE.

TAPI_E_TIMEOUT
The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.

Remarks

If the call is asynchronous, the application will receive information about the call's progress through the ITCallNotificationEvent outgoing interface. The application must register the outgoing interface before calling Connect. Connect may return S_OK, but the actual connection may fail (and the application will be notified through the outgoing interface).

If the call is synchronous, this method will not return until the call is in the connected state or fails.

Requirements

   
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

Call Object

Complete a Session

ITAddress::CreateCall

ITBasicCallControl