The Conference method either begins a new conference call or
adds an additional call to an existing conference call. When it begins a new
conference call, it combines an original two-party call with a two-party
consult call (where the two calls have a common party) into a single three
party call. Only the common party (which is called the
"Conference Controller") can call this method to make the new
conference call. You can call this method on either of the Conference
Controller's calls.
Syntax
- C++
int Conference();
int Conference(Arguments& optional_args)
- COM
HRESULT Conference ( /*[in, optional]*/ IArguments *optional_args, (/*[out, retval]*/ int * errorcode )
- VB
Conference([optional_args As IArguments]) As Long
- Java
int Conference(Arguments optional_args)
- .NET
CilError Conference(Arguments optional_args)
Parameters
optional_args
An optional input parameter, which is a pointer or reference to an
Arguments array that contains a member with the string value that is the
UniqueObjectID of the call to which this call is conferenced. If this argument
is used, add it to the Arguments parameter with the keyword of
"CallReferenceObjectID". This is only necessary in an environment
where there are multiple held calls and the request is made through the talking
call. If the request is made through a specific held call in this scenario, or
if there are only two calls at the device, this parameter is unnecessary.
errorcode
An output parameter (return parameter in VB) that contains an error
code from
Table 1.
Remarks
Before making this request, the original call must be in the
held state and the consult call in the talking state or the request fails.
Therefore, if the calls are alternated (see Alternate), they must be alternated
again to return the two calls to their appropriate states.
If there are only two calls at the device, you can call this
method using either the current or held call. For switches which allow more
than two calls at a device (for example G3), make this request through the
desired held call to avoid the ambiguity caused by multiple held calls at the
device. Otherwise, indicate the desired held call using the optional parameter.
You must make the Conference request via a call whose call
status is LCS_CONNECT or LCS_HELD or it fails.
On certain switches (notably Unified CCE), only the
Conference Controller (the party that first initiated the conference call) can
add additional parties to an existing conference call.
The following events are received if this request is
successful:
The following events are received if this request fails: