Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 500
   
10-12
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 10      Call Object
Methods
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 should be 
conferenced. If this argument is used, it should be added to the Arguments parameter with the 
keyword of “CallReferenceObjectID”. This would only be necessary in an environment where there 
are multiple held calls and the request is being made through the talking call. If the request is being 
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 
 in 
Return Value
Default CTI OS return values. See 
Remarks
Before making this request, it is necessary for the original call to be in the held state and the consult call 
to be in the talking state or the request will fail. 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, this method may be called 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.
The Conference request must be made via a call whose call status is LCS_CONNECT or  LCS_HELD 
or it will fail.
On certain switches (notably IPCC), only the Conference Controller (the party that first initiated the 
conference call) may add additional parties to an existing conference call.
The following events will be received if this request is successful: 
OnConferenceCallConf event
OnCallConferenced event
The following events will be received  if this request fails: 
OnControlFailureConf event
GetCallContext
The GetCallContext method returns an Arguments array containing the values for call properties other 
than CallVariables and ECC Variables, such as ANI, DNIS, and the other properties listed in