Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Rejecting and Deflecting an Incoming Call

TELRejectCall

Rejects an incoming call.

pascal TELErr TELRejectCall (TELCAHandle hTELCA, short reason);

hTELCA

A handle to a call appearance structure for an incoming call. You obtain this handle from a telCAAlertingMsg or a telCAOfferMsg message.

reason

Reserved.

function result

A result code.

DESCRIPTION

When your call appearance message handler gets a telCAAlertingMsg or a telCAOfferMsg message, you can call the TELRejectCall function to reject an incoming call if it is rejectable.

A call is rejectable when the rejectable bit in the otherFeatures field of the call appearance structure is set. If the call is not rejectable, you can ignore the call or call the TELAnswerCall function (page 4-30) to answer it.

If TELRejectCall returns noErr, the state of the call appearance changes from either telCAAlertingState or telCAOfferState to telCAIdleState. When your call appearance message handler gets the telCAIdleMsg message, you should dispose of the call appearance structure by calling the TELCADispose function (page 4-52).

You can use TELRejectCall to provide call screening. For instance, if the telephone tool and telephone switch support the caller ID feature, your application can obtain from the user those directory numbers from which the user does not want to receive calls. You can use TELRejectCall to refuse calls from directory numbers the user specifies.