2.2.3.1.38 LINEERR_Constants
The LINEERR_Constants list error codes that TAPI can return when invoking operations on lines, addresses, or calls. For more information about how to determine which of these error codes a particular function can return, see the individual function descriptions.
Constant/value |
Description |
---|---|
LINEERR_ALLOCATED 0x80000001 |
The line cannot be opened because of a persistent condition, such as a serial port that is opened exclusively by another process. |
LINEERR_BADDEVICEID 0x80000002 |
The specified device identifier or line device identifier, such as in a dwDeviceID parameter, is invalid or out of range. |
LINEERR_BEARERMODEUNAVAIL 0x80000003 |
The bearer mode member in LINECALLPARAMS is invalid, the bearer mode that is specified in LINECALLPARAMS is not available, or the call bearer mode cannot be changed to the specified bearer mode. |
LINEERR_CALLUNAVAIL 0x80000005 |
All call appearances on the specified address are currently in use. |
LINEERR_COMPLETIONOVERRUN 0x80000006 |
The maximum number of outstanding call completions has been exceeded. |
LINEERR_CONFERENCEFULL 0x80000007 |
The maximum number of parties for a conference has been reached, or the requested number of parties cannot be satisfied. |
LINEERR_DIALBILLING 0x80000008 |
The dialable address parameter contains dialing control characters that are not processed by the service provider. |
LINEERR_DIALDIALTONE 0x80000009 |
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_INCOMPATIBLEAPIVERSION 0x8000000C |
The application requested a TAPI version or version range that is either incompatible with, or cannot be supported by, the TAPI 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 can be corrupted or inconsistent. |
LINEERR_INUSE 0x8000000F |
The line device is in use and cannot currently be configured to allow a party to be added, a call to be answered, a call to be placed, or a call to be transferred. |
LINEERR_INVALADDRESS 0x80000010 |
A specified address must be 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 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 must be invalid. |
LINEERR_INVALADDRESSSTATE 0x80000013 |
The specified address state contains one or more bits that are not LINEADDRESSSTATE_Constants. |
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 must be 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 must be invalid. |
LINEERR_INVALCALLCOMPLMODE 0x80000017 |
The specified completion must be invalid. |
LINEERR_INVALCALLHANDLE 0x80000018 |
The specified call handle must be not valid. For example, the handle is not NULL but does not belong to the particular line. In some cases, the specified call device handle is invalid. |
LINEERR_INVALCALLPARAMS 0x80000019 |
The specified call parameters must be invalid. |
LINEERR_INVALCALLPRIVILEGE 0x8000001A |
The specified call privilege parameter must be invalid. |
LINEERR_INVALCALLSELECT 0x8000001B |
The specified select parameter must be invalid. |
LINEERR_INVALCALLSTATE 0x8000001C |
The current state of a call must not be in a valid state for the requested operation. |
LINEERR_INVALCALLSTATELIST 0x8000001D |
The specified call state list must be invalid. |
LINEERR_INVALCARD 0x8000001E |
The permanent card identifier that is specified in dwCard could not be found in any entry in the [Cards] section in the registry. |
LINEERR_INVALCOMPLETIONID 0x8000001F |
The completion identifier must be invalid. |
LINEERR_INVALCONFCALLHANDLE 0x80000020 |
The specified call handle for the conference call must be invalid or is not a handle for a conference call. |
LINEERR_INVALCONSULTCALLHANDLE 0x80000021 |
The specified consultation call handle must be invalid. |
LINEERR_INVALCOUNTRYCODE 0x80000022 |
The specified country code must be invalid. |
LINEERR_INVALDEVICECLASS 0x80000023 |
The line device has no associated device for the indicated device class, or the specified line must not support the indicated device class. |
LINEERR_INVALDEVICEHANDLE 0x80000024 |
The line device handle must be invalid. |
LINEERR_INVALDIALPARAMS 0x80000025 |
The dialing parameters must be invalid. |
LINEERR_INVALDIGITLIST 0x80000026 |
The specified digit list must be invalid. |
LINEERR_INVALDIGITMODE 0x80000027 |
The specified digit mode must be invalid. |
LINEERR_INVALDIGITS 0x80000028 |
The specified termination digits must be invalid. |
LINEERR_INVALEXTVERSION 0x80000029 |
The service provider extension version number must be invalid. |
LINEERR_INVALGROUPID 0x8000002A |
The specified group identifier must be invalid. |
LINEERR_INVALLINEHANDLE 0x8000002B |
The specified call, device, line device, or line handle must be invalid. |
LINEERR_INVALLINESTATE 0x8000002C |
The device configuration cannot be changed in the current line state. The line can 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 out of service. These states are indicated by setting the bits that correspond to the LINEDEVSTATUSFLAGS_CONNECTED and LINEDEVSTATUSFLAGS_INSERVICE values to 0 in the dwDevStatusFlags member of the LINEDEVSTATUS packet that is returned by the GetLineDevStatus packet. |
LINEERR_INVALLOCATION 0x8000002D |
The permanent location identifier that is specified in dwLocation could not be found in any entry in the [Locations] section in the registry. |
LINEERR_INVALMEDIALIST 0x8000002E |
The specified media list must be invalid. |
LINEERR_INVALMEDIAMODE 0x8000002F |
The list of media types (modes) to be monitored contains invalid information, the specified media type parameter must be invalid, or the service provider does not support the specified media type. The media types that are supported on the line are listed in the dwMediaModes member in the LINEDEVCAPS packet. |
LINEERR_INVALMESSAGEID 0x80000030 |
The number that is specified in dwMessageID must be outside the range that is specified by the dwNumCompletionMessages member in the LINEADDRESSCAPS packet. |
LINEERR_INVALPARAM 0x80000032 |
A parameter or packet that a parameter points to contains invalid information; a country code is invalid; a window handle is invalid; or the specified forward list parameter contains invalid information. |
LINEERR_INVALPARKID 0x80000033 |
The park identifier must be invalid. |
LINEERR_INVALPARKMODE 0x80000034 |
The specified park mode must be invalid. |
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. |
LINEERR_INVALRATE 0x80000037 |
The specified rate must be invalid. |
LINEERR_INVALREQUESTMODE 0x80000038 |
The LINEREQUESTMODE indicator is invalid. |
LINEERR_INVALTERMINALID 0x80000039 |
The specified terminal identifier must be invalid. |
LINEERR_INVALTERMINALMODE 0x8000003A |
The specified terminal modes parameter must be invalid. |
LINEERR_INVALTIMEOUT 0x8000003B |
Time-outs are not supported or a value falls outside the valid range that is 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 packet does not describe a valid tone. |
LINEERR_INVALTONELIST 0x8000003D |
The specified tone list is invalid. |
LINEERR_INVALTONEMODE 0x8000003E |
The specified tone mode parameter must be invalid. |
LINEERR_INVALTRANSFERMODE 0x8000003F |
The specified transfer mode parameter must be invalid. |
LINEERR_LINEMAPPERFAILED 0x80000040 |
LINEMAPPER was the value that was passed in the dwDeviceID parameter; however, no lines were found that match the requirements that are specified in the lpCallParams parameter. |
LINEERR_NOCONFERENCE 0x80000041 |
The specified call must not be 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 computer since TAPI was last initialized. Alternately, the line device has no associated device for the particular device class. |
LINEERR_NODRIVER 0x80000043 |
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 is 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_NOREQUEST 0x80000045 |
No request is currently pending for 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 privileges 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 particular device or specified line. |
LINEERR_RATEUNAVAIL 0x8000004A |
The service provider currently does not have enough bandwidth available for the specified rate. |
LINEERR_RESOURCEUNAVAIL 0x8000004B |
Insufficient resources to complete the operation. For example, a line cannot be opened because a dynamic resource is over committed. |
LINEERR_REQUESTOVERRUN 0x8000004C |
More requests are pending than the device can handle. |
LINEERR_STRUCTURETOOSMALL 0x8000004D |
The dwTotalSize member of a packet does not specify enough memory to contain the fixed portion of the specified packet. |
LINEERR_TARGETNOTFOUND 0x8000004E |
A target for the call handoff was not found. This condition can occur if the same line did not open with the LINECALLPRIVILEGE_OWNER bit in the dwPrivileges parameter of the Open packet. Or in the case of media-mode handoff, the same line was not opened with the LINECALLPRIVILEGE_OWNER bit in the dwPrivileges parameter of the Open packet and with the media type specified in the dwMediaMode parameter having been specified in the dwMediaModes parameter of the Open packet. |
LINEERR_TARGETSELF 0x8000004F |
The application invoking this operation must be the target of the indirect handoff. That is, TAPI has determined that the calling application is also the highest-priority application for the specified media type. |
LINEERR_UNINITIALIZED 0x80000050 |
The operation was invoked before any application sends the Initialize packet. |
LINEERR_USERUSERINFOTOOBIG 0x80000051 |
The string that contains user-user information exceeds the maximum number of bytes that is specified in the dwUUIAcceptSize, dwUUIAnswerSize, dwUUIDropSize, dwUUIMakeCallSize, or dwUUISendUserUserInfoSize member of LINEDEVCAPS; or the string that contains user-user information is too long. |
LINEERR_REINIT 0x80000052 |
If TAPI re-initialization has been requested (for example, because of adding or removing a telephony service provider), the Initialize packet and the Open packet requests are rejected by using this error until the last application shuts down its usage of the TAPI by using the Shutdown packet; at which time, the new configuration becomes effective, and applications are again permitted to send the Initialize packet. |
LINEERR_ADDRESSBLOCKED 0x80000053 |
The address is blocked. |
LINEERR_BILLINGREJECTED 0x80000054 |
The billing mode of the call was rejected. |
LINEERR_INVALFEATURE 0x80000055 |
The application invoked a feature that is not available on this line. |
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 advises the user to use the Telephony Control Panel to remove the duplicate driver. |
The following constants are present in TAPI versions 2.0, 2.1, 2.2, 3.0, and 3.1.
Constant/value |
Description |
---|---|
LINEERR_INVALAGENTID 0x80000057 |
An invalid agent identifier was used. |
LINEERR_INVALAGENTGROUP 0x80000058 |
The application referenced an agent group that is not valid. |
LINEERR_INVALPASSWORD 0x80000059 |
The application used an invalid password. |
LINEERR_INVALAGENTSTATE 0x8000005A |
The application referenced an agent state that is not valid. |
LINEERR_INVALAGENTACTIVITY 0x8000005B |
The specified agent activity is not valid. |
LINEERR_DIALVOICEDETECT 0x8000005C |
Use of the dial modifier (:) is not supported. |
The following constants are present in TAPI versions 2.2, 3.0, and 3.1.
Constant/value |
Description |
---|---|
LINEERR_USERCANCELLED 0x8000005D |
The user canceled the call. |
LINEERR_INVALAGENTSESSIONSTATE 0x8000005F |
The agent session state is invalid. |
LINEERR_DISCONNECTED 0X80000060 |
The call has been disconnected. |
LINEERR_SERVICE_not_RUNNING 0X80000061 |
The service must not be running. |
The following constants are present in TAPI versions 3.0 and 3.1.
Constant/value |
Description |
---|---|
LINEERR_INVALADDRESSTYPE 0x8000005E |
The application referenced an address type that must not be valid. |
If an unknown error is returned, such as an error that is defined by a device-specific extension, it SHOULD be treated as a LINEERR_OPERATIONFAILED (for an unspecified reason).