Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Accepting and Answering an Incoming Call

TELAcceptCall

Accepts an incoming call.

pascal TELErr TELAcceptCall (TELCAHandle hTELCA);

hTELCA

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

function result

A result code.

DESCRIPTION

The TELAcceptCall function accepts a call that is being offered at the telephone terminal, if the call is acceptable. When a call is being offered, your call appearance message handler receives a telCAOfferMsg message.

A call is acceptable if the acceptable bit in the otherFeatures field of the call appearance structure specified by the hTELCA parameter is set. If the call is not acceptable, you can ignore the call or call the TELRejectCall function (page 4-31) to reject it.

If TELAcceptCall returns noErr, the state of the call appearance changes to telCAAlertingState and your call appearance message handler receives a telCAAlertingMsg message.You can then call the TELAnswerCall function (page 4-30) to answer the call.

SEE ALSO

Calling the TELAnswerCall function (page 4-30) is also a valid response to a CAOfferMsg message. For more information, see the description of the CAOfferMsg message.