Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Transferring a Call

TELTransferEstablish

Completes a supervised transfer by connecting the party to be transferred with the new destination party.

pascal TELErr TELTransferEstablish (
                     TELCAHandle hTELCA1, 
                     TELCAHandle hTELCA2);

hTELCA1

A handle to the call appearance structure for the call to transfer. Provide the same handle that you passed to the TELTransferPrep function (page 4-35) in its hTELCA1 parameter.

hTELCA2

A handle to the call appearance structure for the new destination number. Provide the same handle that you passed to TELTransferPrep in its hTELCA2 parameter.

function result

A result code.

DESCRIPTION

Before calling the TELTransferEstablish function, you must have already called the TELTransferPrep function (page 4-35). The state of the call appearance referenced by hTELCA2 must be telCAActiveState. The TELTransferEstablish function completes the transfer by connecting the remote parties referenced by hTELCA1 and hTELCA2.

The call appearances you use for the transfer persist for varying amounts of time, depending on the telephone tool and the network switch. Your application need not be concerned with the differences. When your message handler gets a telCAIdleMsg message for a call appearance referenced by hTELCA1 or hTELCA2, call the TELCADispose function (page 4-52) to dispose of the call appearance structure.

SEE ALSO

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