Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 668
 
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.1(1) 
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, and .NET). 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 
Document
ed Data 
Type
STRING
INT
UNSIGNED 
INT
SHORT
UNSIGNED 
SHORT
BOOL
ARGUME
NTS
ARG
C++ Type
std::string 
OR const 
char 
long 
OR int
unsigned int short
unsigned 
short
bool
Argumen
ts
Arg