Inside Macintosh: Telephony /

Chapter 3 - Directory Numbers / Directory Number Reference

Directory Number Functions / Setting Forwarding Modes

TELForwardSet

Causes incoming calls for one directory number to be forwarded to another.

pascal TELErr TELForwardSet (
                     TELDNHandle hTELDN, 
                     ConstStr255Param forwardDN, 
                     ConstStr255Param forwardName, 
                     ConstStr255Param forwardSubaddress, 
                     short forwardType, 
                     short numrings);

hTELDN

A handle to the directory number structure for the directory number whose calls are to be forwarded.

forwardDN

A pointer to a Pascal-style string containing the directory number to which calls are to be forwarded.

forwardName

A pointer to a Pascal-style string containing the name of the party whose calls are to be forwarded.

forwardSubaddress

A pointer to a Pascal-style string containing a subaddress, as defined by the ISDN S-Bus. Set this parameter only if the network supports subaddressing; otherwise, the function ignores it. To find out whether the network supports subaddressing, call the TELGetInfo function and check the field hasSubaddress in the telephone structure.

forwardType

The type of forwarding requested. See "Call Forwarding Types" (page 3-11) for descriptions of the constants you can specify here. You should not, however, set this parameter to telForwardTypeUnknown.

numrings

The number of rings you want to occur before a call is forwarded.

function result

A result code.

DESCRIPTION

The TELForwardSet function causes incoming calls for the directory number specified by the hTELDN parameter to be forwarded to the directory number specified by the forwardDN parameter. The type of forwarding is specified by the forwardType parameter.

SEE ALSO

To stop call forwarding, call the TELForwardClear function (page 3-26).