Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Calling Back an Unavailable Party

TELCallbackNow

Places a call in response to a local or remote callback request.

pascal TELErr TELCallbackNow (TELCAHandle hTELCA, short callbackRef);

hTELCA

A handle to a call appearance structure to use for the callback. You get this handle by calling the TELSetupCall function (page 4-24).

callbackRef

A reference value that identifies a callback request. You provide the reference. If you originated the callback request, you can obtain the reference from either the callbackRef parameter returned by the TELCallbackSet function or the mType parameter of the telCACallbackMsg message that has its value parameter set to telCallbackNowAvail to which you are responding. If you are responding to a callback request made by a remote party, you can obtain the reference from the mType parameter of the telCACallbackMsg message that has its value parameter set to telCallbackDesired.

function result

A result code.

DESCRIPTION

You call the TELCallbackNow function in response to a telCACallbackMsg message that has its value parameter set to either telCallbackDesired or telCallbackNowAvail.

A telCACallbackMsg message that has its value parameter set to telCallbackDesired tells you that a remote party wants a return call.

A telCACallbackMsg message that has its value parameter set to telCallbackNowAvail is a notification that a previously busy remote number is available.

SEE ALSO

You use the TELCallbackSet function (page 4-42) to make a callback request.