LINEERR_ Constants

This is the list of error codes that the implementation may return when invoking operations on lines, addresses, or calls. For more information about which of these error codes a particular function can return, see the individual function descriptions in TSPI Functions.

LINEERR_ADDRESSBLOCKED
The specified address is blocked from being dialed on the specified call.
LINEERR_ALLOCATED
The line cannot be opened due to a "persistent" condition, such as that of a serial port being exclusively opened by another process.
LINEERR_BEARERMODEUNAVAIL
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_CALLUNAVAIL
All call appearances on the specified address are currently in use or allocated.
LINEERR_COMPLETIONOVERRUN
The maximum number of outstanding call completions has been exceeded.
LINEERR_CONFERENCEFULL
The maximum number of parties for a conference has been reached or the requested number of parties cannot be satisfied.
LINEERR_DIALBILLING
The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_DIALDIALTONE
The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_DIALPROMPT
The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_DIALQUIET
The dialable address parameter contains dialing control characters that are not processed by the service provider.
LINEERR_INCOMPATIBLEAPIVERSION
The passed TSPI version or version range did not match an interface version definition supported by the service provider.
LINEERR_INCOMPATIBLEEXTVERSION
The passed extension version range did not contain an interface definition version supported by the service provider, or the passed TSPI version did not match an extension version definition supported by the service provider.
LINEERR_INIFILECORRUPT
A required INI file was corrupt in a way that the removal procedure was unable to correct or handle.
LINEERR_INUSE
The line device is in use and cannot currently be configured, allow a party to be added, allow a call to be answered, or allow a call to be placed.
LINEERR_INVALADDRESS
The specified address is invalid, is not assigned to the specified line, contains invalid characters or digits, or is not valid for redirection. This error is also returned if the destination address contains dialing control characters (W, @, $, ?) that are not supported by the server provider.
LINEERR_INVALADDRESSID
The specified address identifier, such as the dwAddressID parameter or in the LINECALLPARAMS structure, is invalid or is out of range.
LINEERR_INVALADDRESSMODE
The address mode specified in LINECALLPARAMS is invalid.
LINEERR_INVALADDRESSSTATE
The specified address state is invalid.
LINEERR_INVALBEARERMODE
The bearer mode, such as specified in LINECALLPARAMS, is invalid.
LINEERR_INVALCALLCOMPLMODE
The specified completion is invalid.
LINEERR_INVALCALLHANDLE
One or more specified call or device handles are invalid.
LINEERR_INVALCALLPARAMS
The specified call parameters, such as in the LINECALLPARAMS structure, are invalid.
LINEERR_INVALCALLSELECT
The specified select parameter is invalid.
LINEERR_INVALCALLSTATE
One or more of the specified calls are not in a valid state for the requested operation.
LINEERR_INVALCALLSTATELIST
The specified call state list is invalid.
LINEERR_INVALCOMPLETIONID
The completion identifier is invalid.
LINEERR_INVALCONFCALLHANDLE
The specified call handle for the conference call is invalid or is not a handle for a conference call.
LINEERR_INVALCOUNTRYCODE
One or more of the specified country codes, such as in the LINEFORWARDLIST structure, are invalid.
LINEERR_INVALDEVICECLASS
The line device has no associated device for the given device class, or the specified line does not support the indicated device class.
LINEERR_INVALDIGITLIST
The specified digit list is invalid.
LINEERR_INVALDIGITMODE
The specified digit mode is invalid or not available.
LINEERR_INVALDIGITS
The specified termination digits are not valid.
LINEERR_INVALFEATURE
The dwFeature parameter is invalid.
LINEERR_INVALGROUPID
The specified group identifier is invalid.
LINEERR_INVALLINEHANDLE
The specified call, device, line device, or line handle is invalid.
LINEERR_INVALLINESTATE
The line is currently not in a state in which this operation can be performed.
LINEERR_INVALMEDIALIST
The specified media list is invalid.
LINEERR_INVALMEDIAMODE
One or more media modes specified as a parameter, in the media mode member in the LINECALLPARAMS structure or in a list, is invalid or not supported by the the service provider.
LINEERR_INVALMESSAGEID
The number given in dwMessageID is outside the range specified by the dwNumCompletionMessages member in the LINEADDRESSCAPS structure.
LINEERR_INVALPARAM
A parameter or structure pointed to by a parameter contains invalid information.
LINEERR_INVALPARKMODE
The specified park mode is invalid.
LINEERR_INVALPOINTER
One or more of the specified pointer parameters are invalid.
LINEERR_INVALPOINTER
The lpDialParams pointer is non-NULL and invalid.
LINEERR_INVALPOINTER
This error return value is returned if lpToneList has a non-NULL value that is invalid.
LINEERR_INVALRATE
One or more rates, such as specified in the LINECALLPARAMS structure, are invalid.
LINEERR_INVALTERMINALID
The specified terminal mode parameter is invalid.
LINEERR_INVALTERMINALMODE
The specified terminal modes parameter is invalid.
LINEERR_INVALTIMEOUT
The values of either or both of the parameters dwFirstDigitTimeout or dwInterDigitTimeout fall outside the valid range specified by LINEDEVCAPS, or timeouts are not supported.
LINEERR_INVALTONE
The specified tone structure or custom tone does not represent or describe a valid tone, or is made up of too many frequencies.
LINEERR_INVALTONELIST
The specified tone list is invalid.
LINEERR_INVALTONEMODE
The specified tone mode parameter is invalid.
LINEERR_NODEVICE
The line device has no associated device for the given device class.
LINEERR_NODRIVER
This error can be returned from a function when the driver finds that one of its components is corrupt in a way that was not detected at initialization. For example, if a service provider consists of multiple components such as a Virtual Device Driver (VxD), in addition to the usual DLL (exporting the TSPI interface and having the .TSP extension), LINEERR_NODRIVER can be returned to indicate that the VxD component was missing. Advise the user to use the Telephony Control Panel to correct the problem.
LINEERR_NOMEM
Unable to allocate or lock memory.
LINEERR_NOMULTIPLEINSTANCE
TSPI_providerInit was called more than once without an intervening TSPI_providerShutdown (that is, an attempt was made to invoke multiple instances of the provider), when the provider does not support multiple instances.
LINEERR_OPERATIONFAILED
The installation or configuration failed or was cancelled by the user. Alternately, the operation failed for an unknown or unspecified reason.
LINEERR_OPERATIONUNAVAIL
The operation is not available.
LINEERR_RATEUNAVAIL
The service provider currently does not have enough bandwidth available for the rate specified in LINECALLPARAMS.
LINEERR_RATEUNAVAIL
The service provider does currently not have enough bandwidth available for the specified rate, such as given in LINECALLPARAMS.
LINEERR_RESOURCEUNAVAIL
The operation cannot be completed because of resource overcommitment.
LINEERR_RESOURCEUNAVAIL
The operation cannot be completed because of resource overcommitment. This return value may also be returned if too many terminals are set, due either to hardware limitations or to service provider/device driver limitations.
LINEERR_STRUCTURETOOSMALL
The dwTotalSize member of a structure, such as a VARSTRING or LINEFORWARDLIST structure, does not specify enough memory to contain the fixed portion of the structure. The dwNeededSize member has been set to the amount required.
LINEERR_USERUSERINFOTOOBIG
The string containing user-user information is either too long or exceeds the maximum number of bytes specified in one of these members of the LINEDEVCAPS structure: dwUUIAcceptSize, dwUUIAnswerSize, dwUUIDropSize, dwUUIMakeCallSize, or dwUUISendUserUserInfoSize.

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.

See Also

LINEADDRESSCAPS, LINECALLPARAMS, LINEDEVCAPS, LINEFORWARDLIST, TSPI_providerInit, TSPI_providerShutdown, VARSTRING,