Platform SDK: TAPI

ITBasicCallControl::Connect

Attempts to complete the connection of an outgoing call.

HRESULT Connect(
  VARIANT_BOOL fSync
);

Parameters

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

Return Values

Value Meaning
S_OK Method succeeded.
TAPI_E_INVALCALLSTATE Call state must be CS_IDLE.
TAPI_E_TIMEOUT The operation failed because the TAPI 3.0 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

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITBasicCallControl, ITAddress::CreateCall, Call Object