Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Disposing of a Call Appearance

TELCADispose

Disposes of a handle to a call appearance structure.

pascal TELErr TELCADispose (TELCAHandle hTELCA);

hTELCA

A handle to the call appearance structure to be disposed of.

function result

A result code. If you pass an invalid handle, the function returns the telBadCAErr result code.

DESCRIPTION

You should call the TELCADispose function when your application no longer needs any information about the call appearance referenced by hTELCA and always after a call appearance reverts to the idle state. (Your message handler gets a telCAIdleMsg message when a call reverts to idle.)

Disposing of a call appearance structure does not drop the associated call. It simply deletes all structures and information related to the call. As a result, your application can no longer monitor or control the call in any way, but the parties can continue to talk.

SEE ALSO

Call appearances revert to idle after you call the TELDrop (page 4-33), TELReject (page 4-31), or TELDeflect (page 4-32) function.

The functions TELDispose and TELDNDispose can also dispose of call appearance structures.