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).