Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 640
 
Chapter 3      CIL Coding Conventions
CTIOS CIL Data Types
3-2
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.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). 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 
6.0 Type
COM Type
Java Type
.NET Type
STRING
std::string OR 
const char 
String
BSTR
String
System.String
INT
long OR int
Long
long OR int
int
System.Int32
UNSIGNED INT unsigned int
None
unsigned int
long
System.Int64
SHORT
short
Integer
short
short
System.Int16