Inside Macintosh: Telephony /

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

Telephone Manager Initialization Functions / Working With a Telephone Tool

TELToolFunctions

Shows whether a telephone tool supports a specified Telephone Manager function.

pascal TELErr TELToolFunctions (
                     TELHandle hTEL,
                     short msgcode,
                     Boolean *supportsIt);

hTEL

The handle to the telephone record associated with the telephone tool.

msgcode

The message code associated with a particular Telephone Manager function. See Chapter 5 for a complete list of these message codes.

supportsIt

A pointer to a Boolean value that indicates whether the specified message is supported. This function returns true if the telephone tool supports the specified Telephone Manager function. A value of false indicates that the function is not supported by the telephone tool.

function result

A result code.

DESCRIPTION

You can use the TELToolFunctions function to check whether a specific telephone tool supports a Telephone Manager function used in your application. The handle (specified by hTEL) is generated when you use the TELNewWithResult function to create a new telephone record for a telephone tool. The message code is generally composed of the function name appended with the suffix Msg. (For example, telCACallParkMsg is the message code for the TELCACallPark function.)