Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 546
 
12-5
Cisco ICM Software CTI OS Developer’s Guide Release 6.0(0)
 
Chapter 12      Helper Classes
Arg Class
Syntax
C++:
static Arg& CreateInstance();  // static creation mechanism.
static Arg& CreateInstance(Arg& arg); // static creation 
mechanism.
static bool CreateInstance(Arg ** arg);// static creation 
mechanism, alternate version
COM: 
Wrapped by CoCreateInstance 
VB:
Wrapped by New 
Java:
Not available
Parameters
arg
(output) Pointer to the newly created Arg.
Return Values
COM: Default HRESULT return values. Se
Others: Either a reference to the newly created Arg or a boolean indicating 
method success. If the methods not returning bool are unsuccessful, they will raise 
a CCtiosException with iCode set to 
E_CTIOS_ARGUMENT_ALLOCATION_FAILED.
Remarks
Internally this method increments the Arg’s reference count, so do not call 
AddRef(). However, you must call Release() after you are finished with the Arg.
Dump Arg
The DumpArg method builds a string containing the value stored in the Arg. This 
involves doing any type conversion required to display the data as a string. For 
example, it will automatically convert an INTEGER type to a string that can be 
logged for debugging. In the event that a Arg object is actually an Arguments 
object, the string returned is the one built by Arguments.DumpArg, and thus 
enabled printing of nested Arguments structures.