Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
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.
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
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.
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.
it will fail.