Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 546
 
Chapter 3      CIL Coding Conventions
CTIOS CIL Data Types
3-2
Cisco ICM Software CTI OS Developer’s Guide Release 6.0(0)
CTIOS CIL Data Types
The CTI OS Client Interface Library is designed to be a single interface, which 
can be used across multiple languages and environments (e.g. C++, COM, Visual 
Basic, Java). However, each programming language has its own native data types. 
Throughout this document, the interface parameters will be listed with the 
following standardized data types:
STRING: This is a variable-length string variable. If a maximum length 
exists, it is listed with the parameter description.
INT: This is a 32-bit wide integer. 
UNSIGNED INT: This is a 32-bit wide unsigned integer. 
SHORT: This is a 16-bit wide short integer. 
UNSIGNED SHORT: This is a 16-bit wide unsigned short integer. 
BOOL: This is a logical true or false variable. Different implementations will 
use different sized variables 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: This is a custom data structure used by CTI OS, which holds 
a variable-length set of key-value pairs.
ARG: This is an individual element (value), which can be stored in an 
ARGUMENTS structure.
 describes the appropriate language specific types to which the 
documented type are associated.
Table 3-1
CTI OS CIL Data Type
Documented Data 
Type
C++ Type
Visual Basic 
Type
COM Type
Java Type
STRING
std::string OR 
const char 
String
BSTR
String
INT
long OR int
Long
long OR int
int
UNSIGNED INT
unsigned int
None
unsigned int
long
SHORT
short
Integer
short
short