Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 546
 
Chapter 10      Call Object
Methods
10-14
Cisco ICM Software CTI OS Developer’s Guide Release 6.0(0)
ClearConnection
The ClearConnection method clears a single connection from a call. If there are 
only two parties to the call, this effectively clears the call, however for a 
multi-party conference call, only the one connection is dropped.
Syntax
C++:
int ClearConnection()
int ClearConnection(Arguments & reserved_args);
COM:
HRESULT ClearConnection (/*[in,optional]*/  IArguments 
*reserved_args,    (/*[out, retval]*/ int * errorcode)
VB:
ClearConnection([reserved_args As IArguments]) As Long
Java:
int ClearConnection(Arguments reserved_args);
Parameters
reserved_args
Not currently used, reserved for future use.
errorcode
An output parameter (return parameter in VB) that contains an error code 
from 
 in 
Return Value
Default CTI OS return values. Se
Remarks
As with the Clear method, under certain switches the ClearConnection request 
must be made via a call whose status is LCS_CONNECT or LCS_INITIATE or it 
will fail. Many other switches allow the Clear method to be called via a call whose 
status is LCS_ALERTING or LCS_HOLD. It may never be made via a call whose 
status is LCS_NULL indicating that it has already been cleared. 
The following events will be received  if this request is successful: 
OnClearConnectionConf event