Inside Macintosh: Telephony /

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

Telephone Manager Initialization Functions / Configuring a Telephone Tool Through a Scripting Language

TELGetConfig

Returns a null-terminated string describing the configuration for a specified telephone tool.

pascal Ptr TELGetConfig (TELHandle hTEL);

hTEL

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

function result

A pointer to a null-terminated configuration string. A nil value is returned if an error occurs.

DESCRIPTION

The null-terminated, C-style string returned by the telephone tool contains tokens that fully describe the configuration of the telephone record. You can use this string to determine how a telephone tool is configured. You can then modify the string to reflect any desired changes in the configuration and then implement the changes by supplying the modified string through the TELSetConfig function.

Note

You are responsible for disposing of the pointer to the configuration string.