Inside Macintosh: Telephony /

Chapter 5 - Telephone Manager Messages / Telephone Manager Message Reference

Constants

Call Progress Signals

Some telephone networks provide call progress signals when a connection attempt is in progress. Your call appearance message handler gets call progress messages (telCAProgressMsg) if the telephone tool supports them. In a call progress message, the value parameter contains a call progress signal. Use the constants below to interpret the value parameter.

enum {
   telCAPDialTone          = 1,
   telCAPRinging           = 2,
   telCAPDialing           = 3,
   telCAPReorder           = 4,
   telCAPBusy              = 5,
   telCAPRouted            = 6,
   telCAPRoutedOff         = 7,
   telCAPTimeout           = 8,
   telCAPUpdate            = 9,
   telCAPPrompt            = 10,
   telCAPWaiting           = 11,
   telCAPCPC               = 12,
   telCAPNoDialTone        = 13,
   telCAPUnknown           = 15,
   telCAPDialDisabled      = 16,
   telCAPBlacklistedNumber = 17,
   telCAPForbiddenNumber   = 18,
   telCAPModemGuardTime    = 19,
   telCAPLCDetected        = 20,
   telCAPLostLC            = 21
};

Constant descriptions

telCAPDialTone

The outgoing call has a dial tone.

telCAPRinging

The outgoing call is ringing at the remote terminal.

telCAPDialing

Dialing of the remote directory number is in progress.

telCAPReorder

The outgoing call is in a reorder state, usually meaning the call cannot be placed because of network congestion or it cannot be completed as dialed.

telCAPBusy

A busy signal has been detected at the remote directory number.

telCAPRouted

The outgoing call has been routed.

telCAPRoutedOff

The outgoing call has been routed off the telephone network. No further progress information is available.

telCAPTimeout

The outgoing call timed out.

telCAPUpdate

The remote directory number and party name have been updated.

telCAPPrompt

The network is prompting for more information, such as additional digits to complete the call.

telCAPWaiting

The outgoing call is proceeding, but there is no response yet from the destination.

telCAPCPC

The telephone tool has detected a CPC signal.

telCAPNoDialTone

Dial tone not detected for outgoing call.

telCAPUnknown

The call progress state is unknown.

telCAPDialDisabled

The auto-dial modem's blacklist table is full. No outgoing call can be placed until the modem is reset, a period of time elapses, or both.

telCAPBlacklistedNumber

An outgoing call cannot be placed because previous attempts to the same destination directory number resulted in a busy signal. This restriction prevents an auto-dial modem from making unlimited consecutive calls to any particular busy number. After a period of time elapses, this restriction is automatically cleared in the auto-dial modem.

telCAPForbiddenNumber

An outgoing call cannot be placed because there have been too many previous attempts to call the same destination directory number. This restriction prevents an auto-dial modem from making unlimited consecutive calls to any particular number. The restriction persists until the auto-dial modem is reset.

telCAPModemGuardTime

An outgoing call cannot be placed because not enough time has elapsed since the previous attempt to place a call to any directory number. This restriction prevents an auto-dial modem from making rapid consecutive calls. After a period of time elapses, this restriction is automatically cleared in the auto-dial modem.

telCAPLCDetected

The handset is off hook and line current is detected.

telCAPLostLC

An attempt to dial or to answer a call is in progress while the handset is not off hook, or lost line current during dialing.