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,