Call Progress and Error Codes

Some values may overlap with Modem Tag Return Values. Use care not to confuse the two.

Values greater than or equal to zero are progress codes, while values less than zero are errors.

Progress Codes

Code	Description
0	LineIdle Idle (no connection), waiting for call
1	CallBegins Starting outbound call
2	RingAnswered Incoming call answered, no connection yet
3	DialToneOK Dial tone on outbound call
4	DialingOut Dialing outbound call
5	RemoteRinging Remote phone ringing on outbound call
6	RemoteBusy Remote phone busy on outbound call
7	CallConnected Connected (You should not see this value. A stream value is returned at this point)
8	HandedOff Another application is handling the call
9	IncomingCallRQ Incoming call detected
10	TempProblem Temporary modem problem - hang up and retry
11	IncomingCall Incoming call accepted

Error Values

Value	Error
-1	NoModems No modems defined in the system
-2	NoDialTone No dial tone detected on outbound call
-3	RemoteBusyErr Remote phone busy on outbound call
-4	NoAnswer No answer on outbound call
-5	CallerHungUp Other end hung up an incoming call
-6	ModemUnavail Modem unavailable
-7	CallFailure Other call termination condition

TAPI Errors

Errors equal to or less than -101 correspond to the Microsoft Telephony Interface (TAPI) errors, which are normally numbered from 1. Specific errors that may be encountered are:

Code	TAPI error
-101	TAPI error code 1 (LINEERR_ALLOCATED) - the serial port is in exclusive use by some other process.
-112	TAPI error code 12 (LINEERR_INCOMPATIBLEAPIVERSION) - the system does not have the required version of telephony support (TAPI 2.0 required).
-115	TAPI error code 15 (LINEERR_INUSE) - the line device is in use and cannot currently be configured, nor can it allow a party to be added or a call to be answered, placed, or transferred.
-147	TAPI error code 47 (LINEERR_INVALMEDIAMODE) - the requested media mode could not be accommodated (e.g. voice call request on a non-voice modem).
-167	TAPI error code 67 (LINEERR_NODEVICE) - the specified device identifier, which was previously valid, is no longer accepted because the associated device has been removed from the system since TAPI was last initialized. Alternately, the line device has no associated device for the given device class.
-168	TAPI error code 68 (LINEERR_NODRIVER) - either TAPIAddr.dll could not be located, or the telephone service provider for the specified device found that one of its components is missing or corrupt in a way that was not detected at initialization time. Use the Telephony Control Panel to correct the problem.
-169	TAPI error code 69 (LINEERR_NOMEM) - insufficient memory to perform the operation, or unable to lock memory.
-175	TAPI error code 75 (LINEERR_RESOURCEUNAVAIL) - insufficient resources to complete the operation (e.g. a line cannot be opened due to a dynamic resource over-commitment). Also occurs where a modem is being used by a non-TAPI application.

The full list of possible TAPI error codes:

Error	Code	Error	Code
ALLOCATED	101	INVALMEDIAMODE	147
BADDEVICEID	102	INVALMESSAGEID	148
BEARERMODEUNAVAIL	103	INVALPARAM	150
CALLUNAVAIL	105	INVALPARKID	151
COMPLETIONOVERRUN	106	INVALPARKMODE	152
CONFERENCEFULL	107	INVALPOINTER	153
DIALBILLING	108	INVALPRIVSELECT	154
DIALDIALTONE	109	INVALRATE	155
DIALPROMPT	110	INVALREQUESTMODE	156
DIALQUIET	111	INVALTERMINALID	157
INCOMPATIBLEAPIVERSION	112	INVALTERMINALMODE	158
INCOMPATIBLEEXTVERSION	113	INVALTIMEOUT	159
INIFILECORRUPT	114	INVALTONE	160
INUSE	115	INVALTONELIST	161
INVALADDRESS	116	INVALTONEMODE	162
INVALADDRESSID	117	INVALTRANSFERMODE	163
INVALADDRESSMODE	118	LINEMAPPERFAILED	164
INVALADDRESSSTATE	119	NOCONFERENCE	165
INVALAPPHANDLE	120	NODEVICE	166
INVALAPPNAME	121	NODRIVER	167
INVALBEARERMODE	122	NOMEM	168
INVALCALLCOMPLMODE	123	NOREQUEST	169
INVALCALLHANDLE	124	NOTOWNER	170
INVALCALLPARAMS	125	NOTREGISTERED	171
INVALCALLPRIVILEGE	126	OPERATIONFAILED	172
INVALCALLSELECT	127	OPERATIONUNAVAIL	173
INVALCALLSTATE	128	RATEUNAVAIL	174
INVALCALLSTATELIST	129	RESOURCEUNAVAIL	175
INVALCARD	130	REQUESTOVERRUN	176
INVALCOMPLETIONID	131	STRUCTURETOOSMALL	177
INVALCONFCALLHANDLE	132	TARGETNOTFOUND	178
INVALCONSULTCALLHANDLE	133	TARGETSELF	179
INVALCOUNTRYCODE	134	UNINITIALIZED	180
INVALDEVICECLASS	135	USERUSERINFOTOOBIG	181
INVALDEVICEHANDLE	136	REINIT	182
INVALDIALPARAMS	137	ADDRESSBLOCKED	183
INVALDIGITLIST	138	BILLINGREJECTED	184
INVALDIGITMODE	139	INVALFEATURE	185
INVALDIGITS	140	NOMULTIPLEINSTANCE	186
INVALEXTVERSION	141	INVALAGENTID	187
INVALGROUPID	142	INVALAGENTGROUP	188
INVALLINEHANDLE	143	INVALPASSWORD	189
INVALLINESTATE	144	INVALAGENTSTATE	190
INVALLOCATION	145	INVALAGENTACTIVITY	191
INVALMEDIALIST	146	DIALVOICEDETECT	192
ALLOCATED	101	INVALMEDIAMODE	147