Cisco Cisco Computer Telephony Integration Option 10.5 Developer's Guide

Page of 490
   
12-14
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
Chapter 12      Helper Classes
Arguments Class
CreateInstance (C++ and COM only)
The CreateInstance method creates an object of type Arguments class and sets the reference count of the 
object to 1. It is important to release the object when it is no longer in use in the program.
Syntax
C++:
static Arguments & CreateInstance()
static bool CreateInstance(Arguments ** args)
COM:
Not exposed, called by CoCreateInstance.
VB:
Not exposed, called by New.
Java, .NET:
Not implemented.
Parameters
args
A pointer to the newly created Arguments structure.
Return Value
COM: Default HRESULT return values. See 
Others: Either a reference to the newly created Arguments structure or a boolean indicating method 
success.
Remarks
C++, COM: Internally this method increments the Arg’s reference count, so do not call AddRef(). 
However, you must call Release() when you are finished with the Arg.
DumpArgs
The DumpArgs method builds a string showing all of the members of the Arguments structure in the 
form “key1 = value1; key2 = value2;...”. It is primarily used for debugging.
Note
The trace mask must be set in order to run the DumpArgs method on the Arguements array of call 
variables. For information on setting the trace level, see 
.
Syntax
C++:
string DumpArgs()
COM:
HRESULT DumpArgs([out,retval] BSTR* 
arg_string
);
VB:  
DumpArgs() as String
Java, .NET:
string DumpArgs()
Parameters
arg_string