Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 500
   
6-38
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 6      Event Interfaces and Events
ICallEvents Interface
OnCallRetrieved
Resuming a call previously placed on hold at the agent’s teleset may generate an OnCallRetrieved event. 
With this event the connection status becomes LCS_CONNECT.
Syntax
C++:
void OnCallRetrieved(Arguments& args)
COM:
void OnCallRetrieved (IArguments * args)
VB:
session_OnCallRetrieved (ByVal args As CtiosCLIENTLib.IArguments
Parameters
args
Arguments array containing the following fields.
OnCallServiceInitiatedEvent
The initiation of telecommunications service (“dial tone”) at the agent’s teleset may generate an 
OnCallServiceInitiatedEvent to the CTI Client. However, when the call is made through the software 
there is no way to detect the equivalent of the phone off hook. Therefore, after a call is made this event 
is received in sequence along with the OnCallOriginated and OnCallDelivered events. With this event 
the connection status becomes LCS_INITIATE.
Syntax
C++:
void OnCallServiceInitiatedEvent(Arguments& args)
COM:
void OnCallServiceInitiatedEvent (IArguments * args)
VB:
session_OnCallServiceInitiatedEvent (ByVal args As CtiosCLIENTLib.IArguments)
LineHandle
SHORT
Identifies the teleset line being used.
LineType
SHORT
Indicates the type of the teleset line.
TrunkNumber 
(optional)
INT
The number representing a trunk.
TrunkGroup Number 
(optional)
INT
The number representing a trunk group.
Keyword
Type
Description
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.