LINEERR (Compact 2013)

Article
11/04/2015

3/26/2014

The following list contains the list error codes that TAPI can return when invoking operations on lines, addresses, or calls. Consult the individual function descriptions to determine which of these error codes a particular function can return.

The following table shows the LINEERR constants.

Value	Description
LINEERR_ADDRESSBLOCKED = 0x80000053	The target call address has call blocking enabled.
LINEERR_ALLOCATED = 0x00000001	The line cannot be opened due to a persistent condition, such as that of a serial port being exclusively opened by another process.
LINEERR_BADDEVICEID = 0x00000002	The specified device identifier or line device identifier, such as in a dwDeviceID parameter, is invalid or out of range.
LINEERR_BEARERMODEUNAVAIL = 0x00000003	The bearer mode member in LINECALLPARAMS is invalid, the bearer mode specified in LINECALLPARAMS is not available, or the call's bearer mode cannot be changed to the specified bearer mode.
LINEERR_BILLINGREJECTED = 0x80000054	The billing mode of the call was rejected.
LINEERR_CALLUNAVAIL = 0x0000005	All call appearances on the specified address are currently in use.
LINEERR_COMPLETIONOVERRUN = 0x0000006	The maximum number of outstanding call completions has been exceeded.
LINEERR_CONFERENCEFULL = 0x00000007	The maximum number of parties for a conference has been reached, or the requested number of parties cannot be satisfied.
LINEERR_DIALBILLING = 0x00000008	The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_DIALDIALTONE = 0x00000009	The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_DIALPROMPT = 0x8000000A	The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_DIALQUIET = 0x8000000B	The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_DIALVOICEDETECT = 0x8000005C	Use of the ":" dial modifier is not supported. This value is exposed only to applications that negotiate a TAPI version of 2.0 or later.
LINEERR_INCOMPATIBLEAPIVERSION = 0x8000000C	The application requested a TAPI version or version range that is either incompatible with, or cannot be supported by, the Telephony API implementation and the corresponding service provider.
LINEERR_INCOMPATIBLEEXTVERSION = 0x8000000D	The application requested an extension version range that is either invalid or cannot be supported by the corresponding service provider.
LINEERR_INIFILECORRUPT = 0x8000000E	The Telephon.ini file cannot be read or understood properly by TAPI because of internal inconsistencies or formatting problems. For example, the [Locations], [Cards], or [Countries] section of the Telephon.ini file may be corrupted or inconsistent.
LINEERR_INUSE = 0x8000000F	The line device is in use and cannot currently be configured, allow a party to be added, allow a call to be answered, allow a call to be placed, or allow a call to be transferred.
LINEERR_INVALADDRESS = 0x80000010	A specified address is either invalid or not allowed. If invalid, the address contains invalid characters or digits, or the destination address contains dialing control characters, W, @, $, or ?, that are not supported by the service provider. If the address is not allowed, the specified address is either not assigned to the specified line or is not valid for address redirection.
LINEERR_INVALADDRESSID = 0x80000011	The specified address identifier is either invalid or out of range.
LINEERR_INVALADDRESSMODE = 0x80000012	The specified address mode is invalid.
LINEERR_INVALADDRESSSTATE = 0x80000013	The specified address state contains one or more bits that are not LINEADDRESSSTATE.
LINEERR_INVALAPPHANDLE = 0x80000014	The application handle (such as specified by a hLineApp parameter) or the application registration handle is invalid.
LINEERR_INVALAPPNAME = 0x80000015	The specified application name is invalid. If an application name is specified by the application, it is assumed that the string does not contain any non-displayable characters, and is zero-terminated.
LINEERR_INVALBEARERMODE = 0x80000016	The specified bearer mode is invalid.
LINEERR_INVALCALLCOMPLMODE = x80000017	The specified completion is invalid.
LINEERR_INVALCALLHANDLE = 0x80000018	The specified call handle is not valid. For example, the handle is not NULL but does not belong to the given line. In some cases, the specified call device handle is invalid.
LINEERR_INVALCALLPARAMS = 0x80000019	The specified call parameters are invalid.
LINEERR_INVALCALLPRIVILEGE = 0x8000001A	The specified call privilege parameter is invalid.
LINEERR_INVALCALLSELECT = 0x8000001B	The specified select parameter is invalid.
LINEERR_INVALCALLSTATE = 0x8000001C	The current state of a call is not in a valid state for the requested operation.
LINEERR_INVALCALLSTATELIST = 0x8000001D	The specified call state list is invalid.
LINEERR_INVALCARD = 0x8000001E	The permanent card identifier specified in dwCard could not be found in any entry in the [Cards] section in the registry.
LINEERR_INVALCOMPLETIONID = 0x8000001F	The completion identifier is invalid.
LINEERR_INVALCONFCALLHANDLE = 0x80000020	The specified call handle for the conference call is invalid or is not a handle for a conference call.
LINEERR_INVALCONSULTCALLHANDLE = 0x80000021	The specified consultation call handle is invalid.
LINEERR_INVALCOUNTRYCODE = 0x80000022	The specified country/region code is invalid.
LINEERR_INVALDEVICECLASS = 0x80000023	The line device has no associated device for the given device class, or the specified line does not support the indicated device class.
LINEERR_INVALDEVICEHANDLE = 0x80000024	The line device handle is invalid.
LINEERR_INVALDIALPARAMS = 0x80000025	The dialing parameters are invalid.
LINEERR_INVALDIGITLIST = 0x80000026	The specified digit list is invalid.
LINEERR_INVALDIGITMODE = 0x80000027	The specified digit mode is invalid.
LINEERR_INVALDIGITS = 0x80000028	The specified termination digits are not valid.
LINEERR_INVALEXTVERSION = 0x80000029	The service provider extension version number is invalid.
LINEERR_INVALFEATURE = 0x80000055	The application invoked a feature that is not available on this line.
LINEERR_INVALGROUPID = 0x8000002A	The specified group identifier is invalid.
LINEERR_INVALLINEHANDLE = 0x8000002B	The specified call, device, line device, or line handle is invalid.
LINEERR_INVALLINESTATE = 0x8000002C	The device configuration may not be changed in the current line state. The line may be in use by another application or a dwLineStates parameter contains one or more bits that are not LINEDEVSTATE constants. The LINEERR_INVALLINESTATE value can also indicate that the device is DISCONNECTED or OUTOFSERVICE. These states are indicated by setting the bits corresponding to the LINEDEVSTATUSFLAGS_CONNECTED and LINEDEVSTATUSFLAGS_INSERVICE values to 0 in the dwDevStatusFlags member of the LINEDEVSTATUS structure returned by the lineGetLineDevStatus function.
LINEERR_INVALLOCATION = 0x8000002D	The permanent location identifier specified in the dwLocation parameter in lineSetCurrentLocation could not be found in any entry in the [Locations] section in the registry.
LINEERR_INVALMEDIALIST = 0x8000002E	The specified media list is invalid.
LINEERR_INVALMEDIAMODE = 0x8000002F	The list of media types (modes) to be monitored contains invalid information, the specified media type parameter is invalid, or the service provider does not support the specified media type. The media types supported on the line are listed in the dwMediaModes member in the LINEDEVCAPS structure.
LINEERR_INVALMESSAGEID = 0x80000030	The number given in dwMessageID is outside the range specified by the dwNumCompletionMessages member in the LINEADDRESSCAPS structure.
LINEERR_INVALPARAM = 0x80000032	A parameter or structure that a parameter points to contains invalid information, a country/region code is invalid, a window handle is invalid, or the specified forward list parameter contains invalid information.
LINEERR_INVALPARKID = 0x80000033	The park identifier is invalid.
LINEERR_INVALPARKMODE = 0x80000034	The specified park mode is invalid.
LINEERR_INVALPASSWORD = 0x80000059	The application used an invalid password. This value is exposed only to applications that negotiate a TAPI version of 2.0 or later.
LINEERR_INVALPOINTER = 0x80000035	One or more of the specified pointer parameters, such as lpCallList, lpdwAPIVersion, lpExtensionID, lpdwExtVersion, lphIcon, lpLineDevCaps, and lpToneList, are invalid, or a required pointer to an output parameter is NULL.
LINEERR_INVALPRIVSELECT = 0x80000036	An invalid flag or combination of flags was set for the dwPrivileges parameter in lineOpen.
LINEERR_INVALRATE = 0x80000037	The specified rate is invalid.
LINEERR_INVALREQUESTMODE = 0x80000038	The LINEREQUESTMODE indicator is invalid.
LINEERR_INVALTERMINALID = 0x80000039	The specified terminal identifier is invalid.
LINEERR_INVALTERMINALMODE = 0x8000003A	The specified terminal modes parameter is invalid.
LINEERR_INVALTIMEOUT = 0x8000003B	Timeouts are not supported or a value falls outside the valid range specified in LINEDEVCAPS.
LINEERR_INVALTONE = 0x8000003C	The specified custom tone does not represent a valid tone or is made up of too many frequencies or the specified tone structure does not describe a valid tone.
LINEERR_INVALTONELIST = 0x8000003D	The specified tone list is invalid.
LINEERR_INVALTONEMODE = 0x8000003E	The specified tone mode parameter is invalid.
LINEERR_INVALTRANSFERMODE = 0x8000003F	The specified transfer mode parameter is invalid.
LINEERR_LINEMAPPERFAILED = 0x80000040	LINEMAPPER was the value passed in the dwDeviceID parameter, but no lines were found that match the requirements specified in the lpCallParams parameter.
LINEERR_NOCONFERENCE = 0x80000041	The specified call is not a conference call handle or a participant call.
LINEERR_NODEVICE = 0x80000042	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.
LINEERR_NODRIVER = 0x80000043	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. The user should be advised to use the Telephony Control Panel to correct the problem.
LINEERR_NOMEM = 0x80000044	Insufficient memory to perform the operation, or unable to lock memory.
LINEERR_NOMULTIPLEINSTANCE = 0x80000056	A telephony service provider that does not support multiple instances is listed more than once in the [Providers] section in the registry. The application should advise the user to use the Telephony Control Panel to remove the duplicated driver.
LINEERR_NOREQUEST = 0x80000045	There currently is no request pending of the indicated mode, or the application is no longer the highest-priority application for the specified request mode.
LINEERR_NOTOWNER = 0x80000046	The application does not have owner privilege to the specified call.
LINEERR_NOTREGISTERED = 0x80000047	The application is not registered as a request recipient for the indicated request mode.
LINEERR_OPERATIONFAILED = 0x80000048	The operation failed for an unspecified or unknown reason.
LINEERR_OPERATIONUNAVAIL = 0x80000049	The operation is not available, such as for the given device or specified line.
LINEERR_RATEUNAVAIL = 0x8000004A	The service provider currently does not have enough bandwidth available for the specified rate.
LINEERR_REINIT = 0x80000052	If TAPI reinitialization has been requested, for example as a result of adding or removing a telephony service provider, then lineInitialize, lineInitializeEx, or lineOpen requests are rejected with this error until the last application shuts down its usage of TAPI (using lineShutdown), at which time the new configuration becomes effective and applications are once again permitted to call lineInitialize or lineInitializeEx.
LINEERR_REQUESTOVERRUN = 0x8000004C	More requests are pending than the device can handle.
LINEERR_RESOURCEUNAVAIL = 0x8000004B	Insufficient resources to complete the operation. For example, a line cannot be opened due to a dynamic resource overcommitment.
LINEERR_STRUCTURETOOSMALL = 0x8000004D	The dwTotalSize member of a structure does not specify enough memory to contain the fixed portion of the specified structure.
LINEERR_TARGETNOTFOUND = 0x8000004E	A target for the call handoff was not found. This can occur if the named application did not open the same line with the LINECALLPRIVILEGE_OWNER bit in the dwPrivileges parameter of lineOpen. Or, in the case of media-mode handoff, no application has opened the same line with the LINECALLPRIVILEGE_OWNER bit in the dwPrivileges parameter of lineOpen and with the media type specified in the dwMediaMode parameter having been specified in the dwMediaModes parameter of lineOpen.
LINEERR_TARGETSELF = 0x8000004F	The application invoking this operation is the target of the indirect handoff. That is, TAPI has determined that the calling application is also the highest priority application for the given media type.
LINEERR_UNINITIALIZED = 0x80000050	The operation was invoked before any application called lineInitialize or lineInitializeEx.
LINEERR_USERUSERINFOTOOBIG = 0x80000051	The string containing user-user information exceeds the maximum number of bytes specified in the dwUUIAcceptSize, dwUUIAnswerSize, dwUUIDropSize, dwUUIMakeCallSize, or dwUUISendUserUserInfoSize member of LINEDEVCAPS, or the string containing user-user information is too long.

Remarks

The values 0xC0000000 through 0xFFFFFFFF are available for device-specific extensions. The values 0x80000000 through 0xBFFFFFFF are reserved, while 0x00000000 through 0x7FFFFFFF are used as request identifiers.

If an application gets an error return that it does not specifically handle, such as an error defined by a device-specific extension, it should treat the error as an error that occurred for an unspecified reason of type LINEERR_OPERATIONFAILED.

When invoking the LINEERR constants, which are new with TAPI 3.0, the Tapierr.mc file must be updated with new messages.

Requirements

Header

tapi.h

LINEERR (Compact 2013)

Remarks

Requirements

See Also

Reference

Additional resources