ITBasicCallControl::Connect method (tapi3if.h)

Article
02/22/2024

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

Syntax

HRESULT Connect(
  [in] VARIANT_BOOL fSync
);

Parameters

[in] 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

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