Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
6-35
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
OnCallFailed
The OnCallFailed event may be generated when a call cannot be completed. With this event the
connection status becomes LCS_FAIL. This would most likely happen as a result of a MakeCall or a
MakeConsultCall request, but can occur at any other point in the call’s lifetime if the call fails on an
ACD. In this case, you should perform any required cleanup prior to arrival of an EndCall event.
connection status becomes LCS_FAIL. This would most likely happen as a result of a MakeCall or a
MakeConsultCall request, but can occur at any other point in the call’s lifetime if the call fails on an
ACD. In this case, you should perform any required cleanup prior to arrival of an EndCall event.
Note
The events (CallConnectionCleared and CallCleared) received after the CallFailed event will not include
a CallStatus, because until the call has ended, it is important to preserve the fact that this is a failed call.
a CallStatus, because until the call has ended, it is important to preserve the fact that this is a failed call.
Syntax
C++:
void OnCallFailed(Arguments& args)
COM:
void OnCallFailed (IArguments * args)
VB:
session_OnCallFailed (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.
OnCallHeld
Placing a call on hold at the agent’s teleset may generate an OnCallHeld event. With this event the
connection status becomes LCS_HELD.
connection status becomes LCS_HELD.
Syntax
C++:
void OnCallHeld(Arguments& args)
COM:
void OnCallHeld (IArguments * args)
VB:
session_OnCallHeld (ByVal args As CtiosCLIENTLib.IArguments)
TrunkNumber (optional)
INT
The number representing a trunk.
TrunkGroup Number
(optional)
(optional)
INT
The number representing a trunk group.
Keyword
Type
Description