Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 500
   
10-8
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 10      Call Object
Methods
Answer (NULL)
Alternate
The Alternate method combines the action of placing a talking call on hold and then retrieving a 
previously held call at the same device. If there are only two calls at the device, this method may be 
called via either the current or the held call. 
Syntax
C++: 
int Alternate()
int Alternate(Arguments & reserved_args);
COM:
HRESULT Alternate (/*[in,optional]*/  IArguments *reserved_args,    (/*[out, 
retval]*/ int * errorcode );
VB:
Alternate([reserved_args As IArguments]) As Long
Java: 
int Alternate(Arguments rArgs);
.NET:
CilError Alternate(Arguments args)
Parameters
reserved_args
A valid Arguments object, which can be empty. Not currently used, reserved for future use.
errorcode
An output parameter (return parameter in VB) that contains an error code from 
 in 
Return Values
Default CTI OS return values. See 
Remarks 
For switches that allow more than two calls at a device (for example G3), it is recommended that this 
request only be made through the desired held call, because of  the ambiguity caused by multiple held 
calls at the device. 
The Alternate request must be made via a call whose status is either LCS_CONNECT or LCS_HELD or 
it will fail.
The following events will be received  if this request is successful.
For the call making the Alternate request:
OnAlternateCallConf event
For the originally current call:
OnCallHeld event
For the originally held call:
OnCallRetrieved event
The following events will be received by the call making the Alternate request if this request fails: