Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 500
   
6-26
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions
Cisco CTI OS Release 7.2(1)
Chapter 6      Event Interfaces and Events
ICallEvents Interface
OnCallConnectionCleared
An OnCallConnectionCleared event is generated when a party drops from a call. With this event the 
connection status becomes LCS_NULL.
Note
If the CallConnectionCleared event is received after having received a CallFailed event, note that the 
event will not include a CallStatus since it is important to preserve the fact that the call failed 
(maintaining the CallStatus of LSC_Fail).  Because of this exception, the CallStatus of the 
CallConnectionCleared event is optional.
Syntax
C++:
void OnCallConnectionCleared(Arguments& args)
COM:
void OnCallConnectionCleared (IArguments * args)
VB:
session_OnCallConectionCleared (ByVal args As CtiosCLIENTLib.IArguments)
Parameters
args
Arguments array containing the following fields.
Keyword
Type
Description
EnablementMask
INT
Contains the bit-mask that specifies what buttons can be enabled or 
disabled when this call is the current call. 
UniqueObjectID
STRING An object ID that uniquely identifies the call object.
CallStatus
SHORT
The current status of the call.
ICMEnterprise 
UniqueID (Optional)
STRING Required only when the call is pre-routed.
OnCallConferenced
The joining of calls into a conference call or the adding of a new call joining a conference may generate 
an OnCallConferenced event. With this event, the connections at the controller’s device merge to become 
one connection with a status of LCS_CONNECT, and the status of the connections at the original caller’s 
device and at the consulted device remain unchanged.
CallStatus
SHORT
The current status of the call.
ICMEnterprise 
UniqueID (Optional)
STRING
Required only when the call is pre-routed.