Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 668
 
12-14
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.1(1)
 
Chapter 12      Helper Classes
Arguments Class
Usage Notes
When writing an application using the CTI OS SDK, the following sequence of 
steps in the program may produce a problem:
  •
Programmer passes an Arguments array into a CTI OS SDK method 
(methodA)
  •
MethodA returns
  •
Programmer modifies the same Arguments array
  •
Programmer passes the modified Arguments array into another CTI OS SDK 
method (methodB)
When running the application, the call to methodA may behave as if it was passed 
the modified Arguments array. This is because many CTI OS methods simply 
place a pointer to the Arguments array on a queue of items to be sent to CTI OS 
server. When the same Arguments array is later modified, as in the preceding 
example, the pointer on the queue now points to the modified array and the 
GetValue (also GetValueInt, 
GetValueUShort, GetValueShort, 
GetValueBool, GetValueUInt, 
GetValueString, GetValueArray, 
GetValueArg)
Returns the value stored under a specified 
key.
IsValid
Tests if a key is present in the current 
Arguments array.
NumElements
Returns the number of arguments in the 
current Arguments array,.
Release
Decrements the reference count for the 
data item.
RemoveItem
Removes an item from an Arguments 
array.
SetElement
Sets the value of an index.
SetValue
Sets the value of a key.
Table 12-5 Arguments Class Methods (continued)
Method
Description