Cisco Cisco Computer Telephony Integration Option 9.0 Guia Do Programador
8-26
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 8 Session Object
Methods
•
E_CTIOS_SET_AGENT_SESSION_DISCONNECT_REQUIRED - You attempted to execute
SetAgent for a session in monitor mode. The SetAgent request will not be sent. To correct, execute
the Disconnect method to disconnect the session, then execute the SetAgent method.
SetAgent for a session in monitor mode. The SetAgent request will not be sent. To correct, execute
the Disconnect method to disconnect the session, then execute the SetAgent method.
•
E_CTIOS_AGENT_ALREADY_IN_SESSION - You attempted to assign an agent that has already
been assigned to this session. The SetAgent request will not be sent.
been assigned to this session. The SetAgent request will not be sent.
Note
In the above error cases, the SetAgent request will not be sent to the CTI OS server, and the client
application will not receive any events in return.
application will not receive any events in return.
•
CIL_OK - The SetAgent request was sent to the CTI OS server.
In Java only, if SetAgent () is called on a session where the current agent is different from the agent that
SetAgent is trying to set, the following occurs:
SetAgent is trying to set, the following occurs:
•
The CIL automatically does a Disconnect on the current session object to Reset an agent.
•
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:
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
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.
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.
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.
memory.
•
E_CTIOS_PROP_ATTRIBUTES_ACCESS_FAILED -- if an error occurred while accessing agent
properties.
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)