Cisco Cisco Computer Telephony Integration Option 8.5 Guida Dello Sviluppatore

Pagina di 668
C H A P T E R
 
3-1
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.1(1)
 
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
  •
UniqueObjectIDs: how to identify objects
  •
Obtaining an object from its 
UniqueObjectID
  •
Using Button Enablement Masks
  •
Methods that call 
AddRef()