Platform SDK: TAPI

ITBasicCallControl::Conference

The conference method adds a consultation call to the conference in which the current call is a participant. If an associated ITCallHub object does not exist, it is created.

HRESULT Conference(
  ITBasicCallControl *pCall,
  VARIANT_BOOL fSync
);

Parameters

pCall
[in] Pointer to the ITBasicCallControl interface for the consultation call.
fSync
[in] Indicates whether the call should be conferenced synchronously (VARIANT_TRUE) or asynchronously (VARIANT_FALSE). See Connect for additional explanation.

Return Values

Value Meaning
S_OK Method succeeded.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
E_POINTER The pCall parameter is not a valid pointer.
E_INVALIDARG The pCall parameter does not point to a valid interface.
TAPI_E_TIMEOUT The operation failed because the TAPI 3.0 DLL timed it out. The timeout interval is two minutes.

Remarks

The consultation call (pCall) is created by ITAddress::CreateCall. The connection is completed by calling the Finish method. Please see Create a Simple Conference for an example of using this method.

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, Finish, ITCallInfo::get_CallHub, Conference Overview, Call Object, Create a Simple Conference