Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Transferring a Call

TELTransferBlind

Transfers a call immediately without first connecting the user to the destination party.

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

hTELCA

A handle to the call appearance structure for the call to transfer.

rmtDN

A pointer to a Pascal-style string containing the directory number to which the call will be transferred. You provide the number.

rmtName

A pointer to a Pascal-style string containing the name of the party associated with the remote directory number. This parameter is optional--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 remote directory number. 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

In a blind transfer, you place a call to another directory number and simultaneously drop your connection to the party being transferred.

You use the TELTransferBlind function to establish a connection between the party to be transferred and the new destination number, just as you use the TELConnect function to place a simple outgoing call. The call appearance referenced by hTELCA reverts to the idle state when the function implicitly drops it. When your message handler gets a telCAIdleMsg message, call the TELCADispose function (page 4-52) to dispose of the call appearance structure.

SEE ALSO

Use the TELTransferPrep (page 4-35) and TELTransferEstablish (page 4-36) functions to accomplish a supervised transfer.