Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 508
   
10-8
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 10      Call Object
Methods
Arguments Parameters
The following rules apply to the optional_args and reserved_args parameters in Call Object methods:
In VB, you can ignore these parameters altogether. For example, you can treat the line:
Answer([reserved_args As IArguments]) As Long
as follows:
Answer()
To ignore these parameters in COM you must send a NULL, as shown:
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.