Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Using Voice Mail, Paging, and Intercom Features

TELIntercom

Accesses an intercom feature defined by the telephone system.

pascal TELErr TELIntercom (TELCAHandle hTELCA, short intercomID);

hTELCA

A handle you provide to a call appearance structure to use for the intercom call. You can get the handle from the TELSetupCall function (page 4-24) or, if the user manually initiates the call, from the telCAOutgoingMsg message. If the telephone system does not require a call appearance when placing an intercom call, set this parameter to nil.

intercomID

An identifier for a specific intercom feature. You need to provide this value if the user's telephone has multiple intercom features. To find out whether the telephone system requires an intercom ID, check the numIntercomIDs field of the directory-number structure associated with hTELCA--it tells you how many intercom keys the terminal supports. If the value of this field is greater than 0, your system requires an intercom ID. Intercom IDs start at 1. If, for example, numIntercomIDs is 5, then you must set intercomID to a value from 1 to 5--not from 0 to 4.

function result

A result code.

DESCRIPTION

The TELIntercom function places a call to an implicit destination--the programmatic equivalent of a user pressing the intercom button on a handset. As a result, you do not need to provide a destination number when you call the TELSetupCall function (page 4-24) to get a handle to a new call appearance structure.