Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 546
C H A P T E R
 
3-1
Cisco ICM Software CTI OS Developer’s Guide Release 6.0(0)
 
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.
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 in order 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