Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

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

TELPaging

Accesses a paging feature defined by the telephone system.

pascal TELErr TELPaging (TELCAHandle hTELCA, short pageID);

hTELCA

A handle you provide to a call appearance structure to use for the page. You can get the handle from the TELSetupCall function (page 4-24) or, if the user manually initiates the call, from the telCAOutgoingMsg message.

pageID

An identifier for a specific paging feature. You need to provide this value if the user's telephone has multiple paging features. To find out whether the telephone system requires a page ID, check the numPageIDs field of the directory-number structure associated with hTELCA. If the value of this field is greater than 0, your system requires a page ID. Page IDs start at 1. If, for example, numPageIDs is 5, then you must set pageID to a value from 1 to 5--not from 0 to 4.

function result

A result code.

DESCRIPTION

The TELPaging function places a call to an implicit destination--the programmatic equivalent of a user pressing the paging 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.

If the telephone network switch requires users to initiate paging by placing a call to a dedicated extension, your application should call the functions TELSetupCall and TELConnect (page 4-27) to place a call to that extension.