Cisco Cisco Computer Telephony Integration Option 9.0 Guia Do Programador

Página de 668
 
Chapter 8      Session Object
Methods
8-10
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.1(1) 
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.