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 Custom Interface

TELSetupCleanup

Disposes of any storage allocated in TELSetupPreflight and performs other cleanup operations.

pasal void TELSetupCleanup (
                     short procID,
                     Ptr theConfig,
                     short count,
                     DialogPtr theDialog,
                     long *magicCookie);

procID

The tool ID for the telephone tool being configured.

theConfig

A pointer to the configuration field in the telephone record for the telephone tool being configured.

count

The number of the first item in the dialog item list that you appended to your custom tool-settings dialog box.

theDialog

A pointer to the dialog box in which configuration is taking place.

magicCookie

A pointer to a reserved area of memory used by the telephone tool to pass relevant dialog items and configuration settings.

DESCRIPTION

The TELSetupCleanup function disposes of any storage allocated by TELSetupPreflight and performs other cleanup operations. If you need to shorten a dialog box, you should do so after calling this function. The tool ID is assigned for a telephone tool through the TELGetProcID function. The dialog item list is stored in a reserved area of memory as specified by the magicCookie pointer assigned through the TELSetupPreflight function. You can determine the number of items in the dialog item list by using the CountDITL function described in Inside Macintosh: Macintosh Toolbox Essentials.