Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

The following line shows this in 

int returnCode = session.Connect(rArgs);

For more information on the possible values and meanings of the int value returned by the Connect() 
method in the Java CIL, see page 4-22.

When successful, the Connect() method generates the OnConnection() event. Code within the 
OnConnection() event should set the connection mode, as described in the next section.

This section contains the following information:

Also see 

If the Connect() method does not succeed, one of the following events is generated:

OnConnectionRejected() event indicates that an unsupported version mismatch has been found.

OnCTIOSFailure() indicates that the CTI OS Server requested in the Connect() method is down. If 
an OnConnectionFailure() event is generated, the application is in Failover and the CIL continues 
to attempt to connect until the connection succeeds or until the application calls Disconnect(). The 
Arguments parameter for the event includes the following keywords:

FailureCode

SystemEventID

SystemEventArg1

ErrorMessage

For more information on the contents of the OnConnectionFailure() event, see the description in 
Chapter 6.

The following field values may be returned by the Connect() method. See the documentation for the 
CtiOs_Enums.CilError interface in the CIL JavaDoc for information on these fields.

CIL_OK - The connection process has successfully begun. The CIL will either fire the 
OnConnection() event to indicate that the CIL successfully connected or will fire the 
OnConnectionFailure() event and go into failover mode. If the latter occurs, the CIL will continue 
to attempt to connect, alternating between hosts CTIOS_CTIOSA and CTIOS_CTIOSB, until the 
connection succeeds, at which point the CIL will fire the OnConnection() event. 

E_CTIOS_INVALID_ARGUMENT - A null Arguments parameter was passed to the Connect() 
method. The connection failed. No events are fired.