Cisco Cisco Computer Telephony Integration OS 8.5 Developer's Guide

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.

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. 

void OnCallFailed(Arguments& args)

void OnCallFailed (IArguments * args)

session_OnCallFailed (ByVal args As CtiosCLIENTLib.IArguments

SkillGroupNumber 
(Optional)

INT

The number of the agent SkillGroup the call is attributed to, as 
known to the peripheral. May contain the special value 
NULL_SKILL_GROUP when not applicable or not available.

SkillGroupID (Optional)

INT

The Unified ICM SkillGroupID of the agent SkillGroup the 
call is attributed to. May contain the special value 
NULL_SKILL_GROUP when not applicable or not available.

SkillGroupPriority 
(Optional)

SHORT

The priority of the skill group, or 0 when skill group priority 
is not applicable or not available.

LineType

SHORT

Indicates the type of the teleset line.

EnablementMask

INT

Contains the bit-mask that specifies what buttons can be 

enabled or disabled when this call is the current call. See 

UniqueObjectID

STRING

An object ID that uniquely identifies the call object.

CallStatus

SHORT

The current status of the call.

ICMEnterpriseUniqueID 
(Optional)

STRING

Required only when the call is pre-routed.

TrunkNumber (optional)

INT

The number representing a trunk.

TrunkGroup Number 
(optional)

INT

The number representing a trunk group.