Inside Macintosh: Telephony /

Chapter 2 - Telephone Terminals / Telephone Terminals Reference

Telephone Terminals Functions / Opening and Closing Telephone Terminals

TELDispose

Disposes of a terminal.

pascal TELErr TELDispose (TELHandle hTEL);

hTEL

A handle to a telephone record associated with a telephone terminal.

function result

A result code.

DESCRIPTION

The TELDispose function disposes of the telephone terminal specified by the hTEL parameter. Disposing of a terminal cancels your application's monitoring of that terminal. TELDispose disposes of all handles associated with directory numbers and call appearances for the specified terminal. In addition, TELDispose removes any directory number and call appearance message handlers registered for the specified terminal.

Note that disposing of a terminal does not drop any call appearances currently active on the terminal. To drop existing call appearances, you must call the TELDrop function.