Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 500
   
8-27
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 8      Session Object
Methods
An OnCloseConnection event is received.
A Connect is then performed.
An OnConnection event is received, and the new agent is set.
In Java only, if the SetAgent request is unsuccessful it returns one of the following 
CtiOs_Enums.CilError codes:
E_CTIOS_INVALID_SESSION -- if session is not connected. 
E_CTIOS_PROP_ATTRIBUTES_ACCESS_FAILED -- if unable to get the connection mode 
property
E_CTIOS_SET_AGENT_SESSION_DISCONNECT_REQUIRED -- if SetAgent request was 
during a Monitor Mode session. The client application will need to call Disconnect first to clean up 
the connection mode and then call Connect again.
E_CTIOS_AGENT_ALREADY_IN_SESSION -- if the agent is already assigned to the session 
object. The client application will need to call Disconnect first to clean up the connection mode and 
then call Connect again.
E_CTIOS_ARGUMENT_ALLOCATION_FAILED -- if the application is unable to allocate 
memory.
E_CTIOS_PROP_ATTRIBUTES_ACCESS_FAILED -- if an error occurred while accessing agent 
properties.
SetCurrentCall
The SetCurrentCall method assigns a call as the session’s current call.
Syntax
C++:
int 
SetCurrentCall(CCall& call)
COM:
 
HRESULT SetCurrentCall (/*{in]*/ICall *call, /*[out, retval]*/ errorcode
VB:
SetCurrentCall (call As CTIOSCLIENTLib.ICall)
Java:
int SetCurrentCall(Call callObject)
.NET:
CilError SetCurrentCall(Call rCall)
Parameters
call
Call to assign as current call.
errorcode
An output parameter (return parameter in VB) that contains an error code from 
 in 
.
Return Values
Default CTI OS return values. See