Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Calling Back an Unavailable Party

TELCallbackClear

Clears a callback request.

pascal TELErr TELCallbackClear (TELHandle hTEL, short callbackRef);

hTEL

A handle to the telephone structure for the user's terminal. You get the handle from either the TELNew or TELNewWithResult function.

callbackRef

A value that identifies the callback request to be cleared. If you originated the callback request, set this parameter to the identifier returned by the TELCallbackSet function (page 4-42) in its callbackRef parameter. If you are clearing a callback request made by a remote party, set it to the value of the mType parameter of the telCACallbackMsg message that has its value parameter set to telCallbackDesired.

function result

A result code.

DESCRIPTION

The TELCallbackClear function clears a callback request, regardless of whether the request originated at the local terminal or a remote terminal. To clear a locally-generated callback request, you must have previously set up the request with the TELCallbackSet function. To clear a remotely-generated callback request, your call appearance message handler will have previously received a telCACallbackMsg message with the value parameter set to telCallbackDesired.