Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Placing an Outgoing Call

TELDialDigits

Generates dual-tone multiple frequency (DTMF) tones.

pascal TELErr TELDialDigits (
                     TELCAHandle hTELCA, 
                     ConstStr255Param digits);

hTELCA

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

digits

A pointer to a Pascal-style string containing a sequence of ASCII digits.

function result

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

DESCRIPTION

The TELDialDigits function generates DTMF tones on the existing call specified by the hTELCA parameter. You can use the tones to navigate automated systems that allow a caller to do such things as check an account balance, get schedule and price information about a tourist attraction, and so forth.

Note

Although the TELConnect function (page 4-27) is the recommended method of placing an outgoing call, you can use TELDialDigits instead if you previously did not provide a complete destination phone number to the TELSetupCall function (page 4-24). In that case, if you provided a partial destination phone number to TELSetupCall, set the string pointed to by the digits parameter to the remaining portion. If you provided no number to TELSetupCall, set it to the full destination phone number. The noErr result code indicates that the telephone tool is attempting to place the call.