Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 508
   
12-21
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 12      Helper Classes
Arguments Class
bool RemoveItem( enum_Keywords key );
COM:
HRESULT RemoveItem(/*[in]*/ VARIANT* key, /*[out, retval]*/
VARIANT_BOOL* bSuccess);
VB: 
RemoveItem ( key as Variant) as Boolean
Java:
boolean RemoveItem(int key)
boolean RemoveItem(String key)
Parameters
key
The key to use to locate and remove the item in the Arguments array. Leading and trailing spaces 
are always removed from the key.
Return Values
COM: Default HRESULT return values. See 
Chapter 3, “CIL Coding Conventions
.
Others: Returns true if the entry was located and removed.
SetElement (C++, COM, and VB only)
The SetElement method is identical to SetValue (which is similar to AddItem), except that it uses an 
index value instead of a key. 
Syntax
C++:
bool SetElement( int index, int value );
bool SetElement( int index, unsigned int value );
bool SetElement( int index, unsigned short value );
bool SetElement( int index, short value );
bool SetElement( int index, bool value );
bool SetElement( int index, std::string& value );
bool SetElement( int index, char * pchar );
bool SetElement( int index, Arg& value );
bool SetElement( int index, Arguments& value );
COM: 
HRESULT SetElement(/*[in]*/ int index, /*[in]*/ VARIANT *
value, /*[out,retval]*/ success);
VB:
SetElement (index as Integer, value as Variant) as Boolean
Java:
Not available.
.NET:
Not available.
Parameters
index
The index at which the value is to be set. This index value is not related to the order in which items 
are added or removed. The order of items in Arguments is never guaranteed. This method is useful 
for sequentially iterating over all items in Arguments. Index is 1-based. Index should never be less 
than 1 or greater than NumElements (see above). C++ implements several overloaded methods for 
different value types, while COM and VB use Variants.
value
The associated value to be set in the element at the designated index.