CTI OS CIL Data Types
The CTI OS Client Interface Library is designed to be a single interface, which you can use across multiple languages and environments (e.g. C++, COM, Visual Basic, Java, and .NET). However, each programming language has its own native data types. Throughout this document, the interface parameters are listed with the following standardized data types:
-
STRING: A variable-length string variable. If a maximum length exists, it is listed with the parameter description.
-
INT: A 32-bit wide integer.
-
UNSIGNED INT: A 32-bit wide unsigned integer.
-
SHORT: A 16-bit wide short integer.
-
UNSIGNED SHORT: A 16-bit wide unsigned short integer.
-
BOOL: A logical true or false variable. Different implementations use variables of different sizes to represent this type. In COM, the VARIANT_BOOL is used. Tests of variables of this data type must be against VARIANT_TRUE and VARIANT_FALSE and not simply against 0 or 1.
-
ARGUMENTS: A custom data structure used by CTI OS, which holds a variable-length set of key-value pairs.
-
ARG: An individual element (value), which can be stored in an ARGUMENTS structure.
The following table describes the appropriate language specific types to which the documented type are associated.
Documented Data Type |
STRING |
INT |
UNSIGNED INT |
SHORT |
UNSIGNED SHORT |
BOOL |
ARGUMENTS |
ARG |
C++ Type |
std::string or const char |
long or int |
unsigned int |
short |
unsigned short |
bool |
Arguments |
Arg |
Visual Basic 6.0 Type |
String |
Long |
None |
Integer |
Integer |
Boolean |
Arguments |
Arg |
COM Type |
BSTR |
long or int |
unsigned int |
short |
unsigned short |
VARIANT_BOOL |
IArguments * |
IArg* |
Java Type |
String |
int |
long |
short |
int |
Boolean |
Arguments |
Arg |
.NET Type |
System.String |
System.Int32 |
System.Int64 |
System.Int16 |
System.Int32 |
System.Boolean |
Arguments |
Arg |