Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Placing an Outgoing Call

TELConnect

Places a simple outgoing call.

pascal TELErr TELConnect (TELCAHandle hTELCA);

hTELCA

A handle to a call appearance structure. You provide the handle you obtained from the TELSetupCall function (page 4-24).

function result

A result code. If you pass an invalid handle, the function returns the telBadCAErr result code.

DESCRIPTION

The TELConnect function places an outgoing call using the information in the call appearance structure specified by the hTELCA parameter. You should specify a structure previously filled in by the TELSetupCall function.

For TELConnect to complete successfully, the call appearance referenced by hTELCA must be in the telCAIdleState state when you call TELConnect.

When TELConnect returns the noErr result code, the telephone tool has accepted the connect request and will attempt to place the call. Depending on the telephone tool you are using, your call appearance message handler may get a series of messages that indicate what is happening with the connection attempt. For example, you might get this sequence of call appearance messages:

• telCAOutgoingMsg
• telCAProgressMsg with the value parameter set to telCAPDialTone
• telCAProgressMsg with the value parameter set to telCAPDialing
• telCAProgressMsg with the value parameter set to telCAPUpdate
• telCAProgressMsg with the value parameter set to telCAPRinging
• telCAActiveMsg

SEE ALSO

Call appearance messages are described in Chapter 5.