Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

errorcode

An output parameter (return parameter in VB) that contains an error code 
from 

 in 

Default CTI OS return values. See 

A successful request will result in an OnConnection event.

A failure will result in an OnConnectionFailure event. This means that the CIL is 
in failover. The 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. 

In some cases, additional failure codes and events may occur:

Connect will return a failure code of -1 if it cannot connect with the initial 
side of the duplexed CTIOS server pair chosen from the connect parameters. 
This error code requires no action on the part of the developer as the CIL will 
automatically attempt to connect using the parameters corresponding to the 
other side of the duplexed pair. 

The CIL will retry the connection attempt five times and then will not attempt 
to reconnect any longer. The final OnConnectionFailure event will contain 
the keyword "FinalAttempt" which informs the client application that the CIL 
has discontinued its attempts to reconnect. 

PortA (optional)

INT

TCP/IP port for ctiosA, default = 42028.

PortB (optional)

INT

TCP/IP port for ctiosB, default = 42028. 

Heartbeat (optional)

INT

Heartbeat time, expressed in seconds. If 
not set, default heartbeats are 
configurable on CTI OS server.