Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
10-29
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
Chapter 10 Call Object
Methods
Remarks
Calling this method causes the CTIServer to forward the request to the server application with the
SessionID received in the OnStartRecordingConf event if non-zero, or if that SessionID is zero, to one
or more server applications that have registered the “Cisco:CallRecording” service as described in the
CTI Server Message Reference Guide (Protocol Version 14) for Cisco Unified ICM/Contact Center
Enterprise & Hosted. It fails if there is no recording server available to CTIServer.
SessionID received in the OnStartRecordingConf event if non-zero, or if that SessionID is zero, to one
or more server applications that have registered the “Cisco:CallRecording” service as described in the
CTI Server Message Reference Guide (Protocol Version 14) for Cisco Unified ICM/Contact Center
Enterprise & Hosted. It fails if there is no recording server available to CTIServer.
•
The OnStopRecordConf event is received if this request is successful.
•
The OnControlFailureConf event is received if this request fails.
Transfer
The Transfer method transfers a call to a third party. You can call this method on either the held original
call or the current consult call. If the device has only these two calls, the optional parameter is not
necessary. At the end of a successful transfer, both of these calls are gone from the device. See the
Conference method for more information.
call or the current consult call. If the device has only these two calls, the optional parameter is not
necessary. At the end of a successful transfer, both of these calls are gone from the device. See the
Conference method for more information.
Syntax
C++:
int Transfer();
int Transfer(Arguments& optional_args)
COM:
HRESULT Transfer ( [in, optional] IArguments *optional_args, (/*[out,
retval]*/ int * errorcode )
VB:
Transfer([optional_args As IArguments]) As Long
Java:
int Transfer(Arguments rArgs)
.NET:
CilError Transfer(Arguments args)
Parameters
optional_args
An optional input parameter containing a member with a string value that is the UniqueObjectID of
the call that is participating in the transfer. 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 current 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.
the call that is participating in the transfer. 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 current 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
in
Return Values
Default CTI OS return values. See
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 into their appropriate states.
state or the request fails. Therefore, if the calls are alternated (See Alternate), they must be alternated
again to return the two calls into their appropriate states.