Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 490
   
10-14
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
Chapter 10      Call Object
Methods
Syntax
C++:
int GetCallData(Arguments& args)
COM:
HRESULT GetCallData (/*[out,retval]*/ IArguments ** args)
VB:
GetCallData (CTIOSCLIENTLib.IArguments args)
Java:
Arguments GetCallData()
.NET:
Arguments GetCallData()
Parameters
args
C++, COM, and VB: An output parameter containing a reference or a pointer to an Arguments 
array containing the call data, as described under Remarks.
Return Value
C++, COM, and VB: Default HRESULT return values. See 
Java/.NET: A reference to an Arguments array that, on return, holds parameters described under 
Remarks.
Remarks
This is a convenience method to call and get all of a call’s CallVariables (1 through 10) and ECC Call 
Variables at one time. If only certain call variables are desired, call the appropriate GetValue method for 
each instead.
Access the data in the following way:
To access the values for individual CallVariables from the arguments parameter, use GetValueString 
with either the keywords of “CallVariable1” through ”CallVariable10”. 
To access ECC call data, use the following procedure:
First, get the ECC variables as a whole from the arguments parameter, using GetValueArray with 
the keyword “ECC’. This returns another Arguments array that is nested in the Arguments array 
returned from GetCallData.
To access an individual ECC scalar variable from this Arguments array, use the appropriate 
GetValueString, GetValueInt, etc. depending on the variable’s type, using the string keyword 
“user.VariableName”.
To access an individual ECC array variable from this Arguments array, use the appropriate 
GetValueString, GetValueInt, etc. depending on the variable’s type, using the string keyword 
“user.ArrayName[n] where n is a zero based integer that notes the offset in the array.
Hold
The Hold method holds a current call.
Syntax
C++:
int Hold()
int Hold(Arguments & reserved_args);