Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 640
C H A P T E R
 
3-1
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.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
  •
Methods that call AddRef()