Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Transferring a Call

TELTransferPrep

Places a call in preparation for a supervised transfer.

pascal TELErr TELTransferPrep (TELCAHandle hTELCA1, TELCAHandle hTELCA2);

hTELCA1

A handle to the call appearance structure for the call you want to transfer. You provide this handle. The call appearance must be in the telCAActiveState state.

hTELCA2

A handle to a call appearance structure for the new destination number. You get this handle from the TELSetupCall function (page 4-24).

function result

A result code.

DESCRIPTION

In a supervised transfer, you place a call to another directory number and keep the connection to the party to be transferred while awaiting an outcome, such as an answer, no answer, or a busy signal at the destination number. A supervised transfer gives the user an opportunity to consult with the destination party before completing the transfer.

The TELTransferPrep function places a call to the new destination directory number (analogous to using the TELConnect function to place a simple outgoing call). When the call appearance referenced by hTELCA2 becomes active (your message handler gets a telCAActiveMsg message), the user can talk to the new destination party.

You can complete a supervised transfer by calling the TELTransferEstablish function (page 4-36) to connect the party to be transferred with the new destination party.

SEE ALSO

Use the TELTransferBlind function (page 4-37) to make a blind transfer.