Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Rejecting and Deflecting an Incoming Call

TELDeflectCall

Deflects an incoming call to another directory number.

pascal TELErr TELDeflectCall (
                     TELCAHandle hTELCA, 
                     ConstStr255Param rmtDN, 
                     ConstStr255Param rmtName, 
                     ConstStr255Param rmtSubaddress);

hTELCA

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

rmtDN

A pointer to a Pascal-style string containing the directory number to which the call is to be deflected.

rmtName

A pointer to a Pascal-style string containing the name of the party associated with the directory number to which the call is to be deflected. This is an optional parameter--if you don't have the name, set the pointer to nil.

rmtSubaddress

A pointer to a Pascal-style string containing the subaddress, as defined by the ISDN S-Bus specification, of the directory number to which the call is to be deflected. You should set this parameter if the telephone network supports subaddressing. To find out, call the TELGetInfo function and check the bit hasSubaddress in the telephone structure.

function result

A result code.

DESCRIPTION

When your call appearance message handler gets a telCAAlertingMsg or a telCAOfferMsg message, you can call the TELDeflectCall function to redirect the incoming call to another directory number if the call is deflectable. (A call is deflectable when the deflectable bit is set in the otherFeatures field of the call appearance structure.)

When TELDeflectCall 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).

If TELDeflectCall returns an error, your application can either answer the incoming call or ignore it.