Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Telephone Manager Initialization Functions / Initializing the Telephone Manager

InitTEL

Initializes the Telephone Manager so that its functions are available to your application.

pascal TELErr InitTel (void);

function result

A result code. See "Result Codes" on page 1-58 for a list of result codes that the Telephone Manager may return.

DESCRIPTION

The InitTel function initializes the Telephone Manager. Before initializing the Telephone Manager, you must first initialize the Macintosh Toolbox. You then need to initialize the Communications Resource Manager (by calling the InitCRM function) and the Communications Toolbox Utilities (by calling the InitCTBUtilities function). You must perform this initialization once each time your application starts.

You must call InitTel to initialize the Telephone Manager before your application can begin controlling the features or handling calls provided through a telephone terminal.

SPECIAL CONSIDERATIONS

Your application must check for the presence of the Communications Toolbox before initializing the Telephone Manager. For detailed information on how to check if the Communications Toolbox is active, consult the sample code available in Macintosh Communications Toolbox: Appendix C: Determining Whether the Managers are Installed.

SEE ALSO

See Listing 1-2 on page 1-14 for a function that initializes the Communications Resource Manager, the Communications Toolbox Utilities, and the Telephone Manager.