Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide
12-7
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 12 Helper Classes
Arg Class
Parameters
Value
Output parameter of the specified type containing the value of the Arg.
For COM, this value is of type VARIANT * whose type is one of the types listed in
.
Table 12-3
Variant Types Supported by GetValue (COM)
Return Values
C++
Methods taking no parameters, if successful, will return the value in the object; otherwise, they will raise
a CCtiosException with iCode set to E_CTIOS_INVALID_ARGUMENT.
a CCtiosException with iCode set to E_CTIOS_INVALID_ARGUMENT.
The methods taking a pointer to the variable receiving the result will return true, if the method was able
to get the value, otherwise, false.
to get the value, otherwise, false.
Java
Returns null if method failed.
.NET
Returns false if method failed.
COM
If the method was able to set the variant type of the value (i.e., value->vt) to any of the types listed in
, it returns the value in the appropriate field of the variant. Otherwise it returns VT_EMPTY.
Release
The Release method decrements the reference count for the data item. It is necessary to call Release
when you are finished with a data item that has had its reference count incremented via CreateInstance
or AddRef; otherwise, a memory leak will result.
when you are finished with a data item that has had its reference count incremented via CreateInstance
or AddRef; otherwise, a memory leak will result.
Syntax
C++:
unsigned long Release()
COM:
HRESULT Release()
VB, Java, .NET:
Not used
Variant Type
Standard C++ Type
VT_INT
Int
VT_UINT
Unsigned int
VT_I2
Short
VT_UI2
Unsigned short
VT_BOOL
Bool
VT_BSTR
string, const string and char *