Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Conferencing a Call

TELConferencePrep

Places a call in preparation for adding a party to a conference.

pascal TELErr TELConferencePrep (
                     TELCAHandle hTELCA1, 
                     TELCAHandle hTELCA2, 
                     short numToConference);

hTELCA1

A handle to the call appearance structure for the conference initiator. You provide this handle. On input, the state of the call appearance must be either telCAActiveState or telCAHeldState. On output, the Telephone Manager sets the caRelated bit in the featureFlags field.

hTELCA2

A handle to a call appearance structure for the party to be added to the conference. You get this handle by calling the TELSetupCall function (page 4-24). On output, the Telephone Manager sets the relatedCA field to the handle in hTELCA1.

numToConference

The total number of parties, including the conference initiator, that will be part of the conference call after all parties are added. You must supply a value for this parameter if the numToConferenceRequired bit is set in the call appearance structure referenced by hTELCA1. If you need to provide a value here, you can check the conferenceLimit field in the call appearance structure referenced by hTELCA1 to determine the maximum number of parties you can add to a conference.

function result

A result code.

DESCRIPTION

You use the TELConferencePrep function to connect to a party you want to add to a conference, just as you use the TELConnect function to place a simple outgoing call.

When the call appearance referenced by hTELCA2 becomes active, the user of your application can consult with the new party. Then your application can call the TELConferenceEstablish function (page 4-40) to add the party to the conference. If the user does not want to consult, your application can call TELConferenceEstablish immediately after the call appearance referenced by hTELCA2 becomes active.

Once a normal call is established, you can add one or more parties by calling the following functions in sequence for each added party:

• call TELSetupCall to get a new call appearance structure
• call TELConferencePrep to connect to the party to be added
• call TELConferenceEstablish to add the party to the conference