Cisco Cisco Computer Telephony Integration Option 8.5 Guía Del Desarrollador
8-25
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
Chapter 8 Session Object
Methods
errorcode
An output parameter (return parameter in VB) that contains an error code from
in
Return Values
If the SetAgent request is successful, it returns a CIL_OK CtiOs_Enums.CilError code and sends an
OnSetAgentMode event to the client application.
OnSetAgentMode event to the client application.
In CTI OS Release 7.1(1) , the SetAgent request returns the following error codes:
•
CIL_FAIL - The request to authenticate failed. The SetAgent request is not sent.
•
E_CTIOS_SET_AGENT_SESSION_DISCONNECT_REQUIRED - You attempted to execute
SetAgent for a session in monitor mode. The SetAgent request is not 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 is not 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 is not sent.
been assigned to this session. The SetAgent request is not sent.
Note
In the above error cases, the SetAgent request is not sent to the CTI OS server, and the client
application does not receive any events in return.
application does 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 calls Disconnect first to clean up the
connection mode and then calls Connect again.
during a Monitor Mode session. The client application calls Disconnect first to clean up the
connection mode and then calls Connect again.
•
E_CTIOS_AGENT_ALREADY_IN_SESSION -- if the agent is already assigned to the session
object. The client application calls Disconnect first to clean up the connection mode and then calls
Connect again.
object. The client application calls Disconnect first to clean up the connection mode and then calls
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.