Cisco Cisco Computer Telephony Integration OS 8.5 Guida Dello Sviluppatore
C H A P T E R
3-1
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
3
CIL Coding Conventions
This chapter discusses coding conventions used in the CTI OS Client Interface Library (CIL). Coding
conventions are standard ways of performing common tasks. While the rest of this document discusses
the programming interfaces available with the CIL, this chapter provides useful and practical
explanation of how to program with the CIL– the glue that brings everything together.
conventions are standard ways of performing common tasks. While the rest of this document discusses
the programming interfaces available with the CIL, this chapter provides useful and practical
explanation of how to program with the CIL– the glue that brings everything together.
One of the design goals of the CTI OS CIL is to make programming as easy and consistent as possible
for client developers. As such, many design decisions about the CIL interfaces were made to keep things
simple, clear, and consistent across various objects, methods, and programming environments.
for client developers. As such, many design decisions about the CIL interfaces were made to keep things
simple, clear, and consistent across various objects, methods, and programming environments.
This chapter discusses the following topics:
•
Data types
•
Asynchronous execution (error codes versus events)
•
Generic interfaces with the Arguments structure
•
Optional and reserved parameters
•
Accessing properties and parameters with GetValue
•
Adding parameters to requests with AddItem
•
Setting properties with SetValue
•
UniqueObjectID
s: how to identify objects
•
Obtaining an object from its UniqueObjectID
•
Using Button Enablement Masks
•
Methods that call AddRef()
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:
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.
parameter description.
•
INT: A 32-bit wide integer.
•
UNSIGNED INT: A 32-bit wide unsigned integer.