Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 500
   
8-27
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions
Cisco CTI OS Release 7.2(1)
Chapter 8      Session Object
Methods
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 
Remarks
A successful request results in an OnCurrentCallChanged event.
In Java and .NET, if the call object specified in the call parameter is already the current call, the 
OnCurrentCallChanged event is not fired to the client application and a 
E_CTIOS_CALL_ALREADY_CURRENT_IN_SESSION code is returned.