Cisco Cisco Computer Telephony Integration OS 8.5 Developer's Guide

Page of 500
   
4-12
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions
Cisco CTI OS Release 7.2(1)
Chapter 4      Building Your Application
Using the COM CIL in Visual C++ 7.1(1)
Next Steps
  •
For detailed information on the CTI OS client start up and shut down sequence, see the section 
“Disconnecting from CTI OS Server”.
  •
For detailed information on the CTI OS Client Interface Library objects, see Chapters 8 through 12.
  •
For a sample application written in Visual Basic 6.0, see the Vbphone sample application on the CTI 
OS CD.
Using the COM CIL in Visual C++ 7.1(1)
Note
All C++ applications using COM CIL 7.1(1) must be built using Visual Studio .NET. Applications 
using COM CIL 7.1(1) built with Visual C++ 6.0 are not supported.
Building a custom Win32 (Console or Windows) CTI application in Visual C++ 7.1(1) with COM 
requires knowledge of creating and using COM components in Microsoft Visual C++ 7.1(1). Client 
applications of this type tend to be more complex to build, but more powerful and faster in execution, 
than scripting clients (i.e. Visual Basic). All of the CIL components for COM are distributed as COM 
Dynamic Link Libraries (COM DLL). 
In order to be accessible to COM containers, including Microsoft Visual C++ 7.1(1), COM components 
must be registered with Windows. The components that you will require for programming in Microsoft 
Visual C++ 7.1(1) are:
  •
CTI OS Client library (CTIOSClient.dll). This is the main CIL library for COM. The objects 
available in this library are described  fully in Chapters 8 through 11.
  •
CTI OS Arguments Library (arguments.dll). The Arguments helper class is used extensively in 
CTI OS, and is described fully in 
  •
CTIOS Session Resolver (ctiossessionresolver.dll). This object allows multiple applications or 
controls to use a single CTIOS Session object. It is required when building an application that will 
include the CTIOS ActiveX controls. 
Adding COM Support to your Application
To make use of these objects in your CTI application, your application must support COM. To add COM 
support to your application, you must use one of the following:
  •
Microsoft Foundation Classes (MFC). The following header file are required for MFC applications 
to use COM: afxwin.hafxext.hafxdisp.h, and afxdtctl.h. If you build an application using the 
Microsoft Visual C++ 7.1(1) application wizard, these files are included for you automatically.
  •
Microsoft’s ActiveX Template Library (ATL). To use ATL, include the standard COM header file: 
atlbase.h