Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 508
   
8-7
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 8      Session Object
Methods
Note
This behavior will only occur after global settings download has completed. If global settings 
download has not completed, the CIL will continue to retry until successful. 
The Connect method will cause an OnCTIOSFailure event to be fired to the client indicating the 
current state of the system. This is in addition to OnConnection or OnConnectionFailure. 
The following error codes can occur:
CIL_OK - no obvious errors, application should wait for an event indicating whether or not Connect 
has succeeded 
CIL_FAIL - initial attempt to connect with host has failed. CIL will fire OnConnectionFailure and 
go into failover mode. CIL will continue to attempt to connect, alternating between hosts 
CTIOS_CTIOSA and CTIOS_CTIOSB until connection succeeds at which point CIL will fire 
OnConnection. If application wishes to stop failover, it must call Disconnect.
E_CTIOS_INVALID_ARGUMENT - a null Arguments parameter was supplied. Connect is 
aborted. No events are fired.
E_CTIOS_MISSING_ARGUMENT - indicates that method call provided no value for both 
CTIOS_CTIOSA or CTIOS_CTIOSB. At least one of these values must be provided. Connect is 
aborted. No events are fired.
E_CTIOS_IN_FAILOVER - a previous call to connect failed and CIL is currently in failover 
attempting to establish a connection. This will continue until a connection is established at which 
point the CIL will send OnConnection indicating that previous call to Connect has succeeded. If 
developer wishes to call Connect again with different parameters, he/she must call Disconnect prior 
to calling Connect again. 
E_CTIOS_MODE_CONFLICT - Session is not disconnected (i.e a previous call to Connect is in 
progress or session is already connected). Disconnect must be called before attempting to establish 
another connection. CIL may fire an OnConnection event corresponding to previous call to Connect 
if connection was in progress but will not fire one corresponding to this method call. 
E_CTIOS_SESSION_NOT_CONNECTED - unanticipated error. Connect is aborted. No events 
are fired. 
CreateSilentMonitorManager
The CreateSilentMonitorManager method creates a SilentMonitorManager object instance. To delete the 
object you must call DestroySilentMonitorManager.
Syntax
C++:
 CSilentMonitorManager * CreateSilentMonitorManager(Arguments & args);
COM:
 
HRESULT CreateSilentMonitorManager ( /*[in]*/ IArguments * args, /*[out,retval]*/ 
ISilentMonitorManager * * pISilentMonitor);
VB:
  CreateSilentMonitorManager (ByVal args as CTIOSCLIENTLIB.IArguments) As 
CTIOSCLIENTLIB.ISilentMonitorManager
Java:
 Not available.
.NET:
 Not available.