Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Parking and Picking Up Calls

TELCallPickup

Answers a call that is alerting at a different terminal.

pascal TELErr TELCallPickup (
                     TELCAHandle hTELCA, 
                     ConstStr255Param pickupDN, 
                     short pickupGroupID);

hTELCA

A handle you provide to the call appearance structure for the call being picked up. You get the handle from a telCAAlertingMsg or a telCAOfferMsg message.

pickupDN

A pointer to a Pascal-style string containing a remote directory number. If you want to pick up a call alerting at a specific directory number, set the string to that number. If you want to pick up any alerting call within a pickup group, set this parameter to nil. In that case, the telephone tool selects the call to be picked up. (A pickup group is defined by the telephone network switch.)

pickupGroupID

An identifier for the pickup group to which the alerting directory number belongs. Your application needs to set this parameter if the telephone network switch requires a pickup ID for Call Pickup requests. To find out, check the numPickupIDs field of the directory-number structure associated with this call appearance. If the value of this field is greater than zero, the system requires a pickup ID.

function result

A result code.

DESCRIPTION

After your application calls the TELCallPickup function, your call appearance message handler receives a telCAActiveMsg message, just as it does when answering a normal alerting call.