LINEERR_ 常量

下面是 TAPI 在对线路、地址或呼叫调用操作时可以返回的错误代码列表。 有关如何确定特定函数可以返回的错误代码的详细信息,请参阅各个函数说明。

LINEERR_ADDRESSBLOCKED

指定地址被阻止在指定的呼叫中拨号。

LINEERR_ADDRESSBLOCKED

目标呼叫地址已启用呼叫阻止。

LINEERR_ALLOCATED

由于持久性条件(例如串行端口由另一个进程独占打开),无法打开该行。

LINEERR_BADDEVICEID

指定的设备标识符或行设备标识符(例如 在 dwDeviceID 参数中)无效或超过范围。

LINEERR_BEARERMODEUNAVAIL

LINECALLPARAMS 中的持有者模式成员无效,LINECALLPARAMS 中指定的持有者模式不可用,或者无法将调用持有者模式更改为指定的持有者模式。

LINEERR_BILLINGREJECTED

呼叫的计费模式被拒绝。

LINEERR_CALLUNAVAIL

指定地址上的所有呼叫外观当前都在使用中。

LINEERR_COMPLETIONOVERRUN

已超出未完成调用的最大数目。

LINEERR_CONFERENCEFULL

已达到会议的最大参与方数,或者无法满足请求的参与方数。

LINEERR_DIALBILLING

可拨号地址参数包含服务提供商未处理的拨号控制字符。

LINEERR_DIALDIALTONE

可拨号地址参数包含服务提供商未处理的拨号控制字符。

LINEERR_DIALPROMPT

可拨号地址参数包含服务提供商未处理的拨号控制字符。

LINEERR_DIALQUIET

可拨号地址参数包含服务提供商未处理的拨号控制字符。

LINEERR_DIALVOICEDETECT

不支持使用拨号修饰符 (:) 。 此值仅向协商 TAPI 版本 2.0 或更高版本的应用程序公开。

LINEERR_DISCONNECTED

呼叫已断开连接。 此值仅向协商 TAPI 版本 2.2 或更高版本的应用程序公开。

LINEERR_INCOMPATIBLEAPIVERSION

应用程序请求的 TAPI 版本或版本范围与电话 API 实现和相应的服务提供商不兼容或不受支持。

LINEERR_INCOMPATIBLEEXTVERSION

应用程序请求的扩展版本范围无效或不受相应服务提供商支持。

LINEERR_INIFILECORRUPT

由于内部不一致或格式问题,TAPI 无法正确读取或理解Telephon.ini文件。 例如,Telephon.ini文件的 [Locations]、[Cards] 或 [Countries] 部分可能已损坏或不一致。

LINEERR_INUSE

线路设备正在使用中,当前无法配置、允许添加一方、允许接听呼叫、允许拨打呼叫或允许转移呼叫。

LINEERR_INVALADDRESS

指定的地址无效或不允许。 如果无效,则地址包含无效字符或数字,或者目标地址包含服务提供商不支持 (W、@、$或 ?) 的拨号控制字符。 如果不允许,则指定的地址要么不分配给指定的行,要么对地址重定向无效。

LINEERR_INVALADDRESSID

指定的地址标识符无效或范围外。

LINEERR_INVALADDRESSMODE

指定的地址模式无效。

LINEERR_INVALADDRESSSTATE

指定的地址状态包含一个或多个不是 常量LINEADDRESSSTATE_位。

LINEERR_INVALADDRESSTYPE

应用程序引用了无效的地址类型。 此值仅向协商 TAPI 版本 3.0 或更高版本的应用程序公开。

LINEERR_INVALAGENTACTIVITY

指定的代理活动无效。

LINEERR_INVALAGENTACTIVITY

调用此操作的应用程序是间接移交的目标。 也就是说,TAPI 已确定调用应用程序也是给定媒体类型的最高优先级应用程序。 此值仅向协商 TAPI 版本 2.0 或更高版本的应用程序公开。

LINEERR_INVALAGENTGROUP

指定的代理组信息无效或包含错误。 尚未执行请求的操作。

LINEERR_INVALAGENTGROUP

应用程序引用了无效的代理组。 此值仅向协商 TAPI 版本 2.0 或更高版本的应用程序公开。

LINEERR_INVALAGENTID

指定的代理标识符无效。

LINEERR_INVALAGENTID

使用了无效的代理标识符。 此值仅向协商 TAPI 版本 2.0 或更高版本的应用程序公开。

LINEERR_INVALAGENTSESSIONSTATE

代理会话状态无效。 此值仅向协商 TAPI 版本 2.2 或更高版本的应用程序公开。

LINEERR_INVALAGENTSTATE

指定的代理状态无效或包含错误。 未对指定地址的代理状态进行更改。

LINEERR_INVALAGENTSTATE

应用程序引用了无效的代理状态。 此值仅向协商 TAPI 版本 2.0 或更高版本的应用程序公开。

LINEERR_INVALAPPHANDLE

应用程序句柄 ((如 hLineApp 参数) 指定)或应用程序注册句柄无效。

LINEERR_INVALAPPNAME

指定的应用程序名称无效。 如果应用程序名称由应用程序指定,则假定字符串不包含任何不可显示的字符,并且以零结尾。

LINEERR_INVALBEARERMODE

指定的持有者模式无效。

LINEERR_INVALCALLCOMPLMODE

指定的完成无效。

LINEERR_INVALCALLHANDLE

指定的调用句柄无效。 例如,句柄不是 NULL ,但不属于给定行。 在某些情况下,指定的调用设备句柄无效。

LINEERR_INVALCALLPARAMS

指定的调用参数无效。

LINEERR_INVALCALLPRIVILEGE

指定的调用特权参数无效。

LINEERR_INVALCALLSELECT

指定的 select 参数无效。

LINEERR_INVALCALLSTATE

调用的当前状态对于所请求的操作不是有效的状态。

LINEERR_INVALCALLSTATELIST

指定的调用状态列表无效。

LINEERR_INVALCARD

在注册表的 [Cards] 节中的任何条目中都找不到 dwCard 中指定的永久卡标识符。

LINEERR_INVALCOMPLETIONID

完成标识符无效。

LINEERR_INVALCONFCALLHANDLE

会议呼叫的指定呼叫句柄无效或不是会议呼叫的句柄。

LINEERR_INVALCONSULTCALLHANDLE

指定的咨询呼叫句柄无效。

LINEERR_INVALCOUNTRYCODE

指定的国家或地区代码无效。

LINEERR_INVALDEVICECLASS

线路设备没有给定设备类的关联设备,或者指定的线路不支持指定的设备类。

LINEERR_INVALDEVICEHANDLE

行设备句柄无效。

LINEERR_INVALDIALPARAMS

拨号参数无效。

LINEERR_INVALDIGITLIST

指定的数字列表无效。

LINEERR_INVALDIGITMODE

指定的数字模式无效。

LINEERR_INVALDIGITS

指定的终止数字无效。

LINEERR_INVALEXTVERSION

服务提供程序扩展版本号无效。

LINEERR_INVALFEATURE

dwFeature 参数无效。

LINEERR_INVALFEATURE

应用程序调用了此行上不可用的功能。

LINEERR_INVALGROUPID

指定的组标识符无效。

LINEERR_INVALLINEHANDLE

指定的呼叫、设备、线路设备或线路句柄无效。

LINEERR_INVALLINESTATE

在当前行状态中,设备配置可能不会更改。 该行可能由另一个应用程序使用,或者 dwLineStates 参数包含一个或多个不是 LINEDEVSTATE_常量位LINEERR_INVALLINESTATE值还可以指示设备已断开连接或服务中断。 这些状态是通过将对应于LINEDEVSTATUSFLAGS_CONNECTED的位和LINEDEVSTATUSFLAGS_INSERVICE值设置为 0,在 lineGetLineDevStatus 函数返回的 LINEDEVSTATUS 结构的 dwDevStatusFlags 成员中。

LINEERR_INVALLOCATION

在注册表的 [Locations] 节中的任何条目中都找不到 dwLocation 中指定的永久位置标识符。

LINEERR_INVALMEDIALIST

指定的媒体列表无效。

LINEERR_INVALMEDIAMODE

) 监视 (模式的媒体类型列表包含无效信息、指定的媒体类型参数无效或服务提供商不支持指定的媒体类型。 line 上支持的媒体类型在 LINEDEVCAPS 结构的 dwMediaModes 成员中列出。

LINEERR_INVALMESSAGEID

dwMessageID 中给出的数字超出了 LINEADDRESSCAPS 结构中的 dwNumCompletionMessages 成员指定的范围。

LINEERR_INVALPARAM

参数指向的参数或结构包含无效信息、国家或地区代码无效、窗口句柄无效或指定的转发列表参数包含无效信息。

LINEERR_INVALPARKID

公园标识符无效。

LINEERR_INVALPARKMODE

指定的寄存模式无效。

LINEERR_INVALPASSWORD

指定的密码不正确,并且请求的操作尚未执行。

LINEERR_INVALPASSWORD

应用程序使用的密码无效。 此值仅向协商 TAPI 版本 2.0 或更高版本的应用程序公开。

LINEERR_INVALPOINTER

(一个或多个指定的指针参数(如 lpCallListlpdwAPIVersionlpExtensionIDlpdwExtVersionlphIconlpLineDevCapslpToneList) )无效,或者指向输出参数的必需指针为 NULL

LINEERR_INVALPRIVSELECT

dwPrivileges 参数设置了无效的标志或标志组合。

LINEERR_INVALRATE

指定的速率无效。

LINEERR_INVALREQUESTMODE

LINEREQUESTMODE 指示器无效。

LINEERR_INVALTERMINALID

指定的终端标识符无效。

LINEERR_INVALTERMINALMODE

指定的终端模式参数无效。

LINEERR_INVALTIMEOUT

不支持超时,或者值超出 LINEDEVCAPS 中指定的有效范围。

LINEERR_INVALTONE

指定的自定义音调不表示有效的音调,或者由太多频率组成,或者指定的音调结构不描述有效的音调。

LINEERR_INVALTONELIST

指定的音调列表无效。

LINEERR_INVALTONEMODE

指定的音调模式参数无效。

LINEERR_INVALTRANSFERMODE

指定的传输模式参数无效。

LINEERR_LINEMAPPERFAILED

LINEMAPPER 是在 dwDeviceID 参数中传递的值,但找不到符合 lpCallParams 参数中指定的要求的行。

LINEERR_NOCONFERENCE

指定的呼叫不是会议呼叫句柄或参与者呼叫。

LINEERR_NODEVICE

指定的设备标识符(以前有效)不再被接受,因为自上次初始化 TAPI 以来,关联的设备已从系统中删除。 或者,线路设备没有给定设备类的关联设备。

LINEERR_NODRIVER

无法找到Tapiaddr.dll,或者指定设备的电话服务提供商发现其组件之一缺失或损坏,在初始化时未检测到。 应建议用户使用电话控制面板来更正问题。

LINEERR_NOMEM

内存不足,无法执行操作,或无法锁定内存。

LINEERR_NOMULTIPLEINSTANCE

不支持多个实例的电话服务提供商在注册表的 [提供程序] 节中多次列出。 应用程序应建议用户使用电话控制面板删除重复的驱动程序。

LINEERR_NOMULTIPLEINSTANCE

不允许此服务提供程序的多个实例。

LINEERR_NOREQUEST

当前没有挂起所指示模式的请求,或者应用程序不再是指定请求模式的最高优先级应用程序。

LINEERR_NOTOWNER

应用程序对指定的调用没有所有者权限。

LINEERR_NOTREGISTERED

应用程序未注册为所指示请求模式的请求接收方。

LINEERR_OPERATIONFAILED

操作因未指定或未知原因失败。

LINEERR_OPERATIONUNAVAIL

操作不可用,例如,对于给定的设备或指定的行。

LINEERR_RATEUNAVAIL

服务提供商当前没有足够的带宽可用于指定的速率。

LINEERR_REINIT

如果已请求 TAPI 重新初始化, 例如,由于添加或删除电话服务提供商, lineInitializelineInitializeExlineOpen 请求将被拒绝并出现此错误,直到最后一个应用程序使用 lineShutdown) 关闭其 API (的使用,此时新配置生效,应用程序再次被允许调用 lineInitializelineInitializeEx

LINEERR_REINIT

应用程序尝试初始化 TAPI 两次。

LINEERR_REQUESTOVERRUN

挂起的请求数超过设备可以处理的请求数。

LINEERR_RESOURCEUNAVAIL

资源不足,无法完成操作。 例如,由于动态资源过度使用,无法打开行。

LINEERR_STRUCTURETOOSMALL

结构的 dwTotalSize 成员未指定足够的内存来包含指定结构的固定部分。

LINEERR_TARGETNOTFOUND

找不到呼叫切换的目标。 如果命名应用程序未使用 lineOpendwPrivileges 参数中的LINECALLPRIVILEGE_OWNER位打开同一行,则可能会出现这种情况。 或者,在媒体模式切换的情况下,没有应用程序使用 lineOpendwPrivileges 参数中的LINECALLPRIVILEGE_OWNER位以及已在 lineOpendwMediaModes 参数中指定的 dwMediaMode 参数中指定的媒体类型打开同一行。

LINEERR_TARGETSELF

调用此操作的应用程序是间接移交的目标。 也就是说,TAPI 已确定调用应用程序也是给定媒体类型的最高优先级应用程序。

LINEERR_UNINITIALIZED

该操作是在调用 lineInitialize 或 lineInitializeEx 的任何应用程序之前调用的。

LINEERR_USERCANCELLED

用户取消了呼叫。 此值仅向协商 TAPI 版本 2.2 或更高版本的应用程序公开。

LINEERR_USERUSERINFOTOOBIG

包含用户-用户信息的字符串超过了 LINEDEVCAPS的 dwUUIAcceptSizedwUUIAnswerSizedwUUIDropSizedwUUIMakeCallSizedwUUISendUserUserUserInfoSize 成员中指定的最大字节数,或者包含用户-用户信息的字符串太长。

备注

通过 0xFFFFFFFF 0xC0000000的值可用于特定于设备的扩展。 通过 0xBFFFFFFF 0x80000000的值是保留的,而0x00000000到 0x7FFFFFFF 用作请求标识符。

如果应用程序收到一个错误返回,指出它未专门处理 ((例如由特定于设备的扩展) 定义的错误),则它应将错误视为LINEERR_OPERATIONFAILED (,原因) 未指定。

调用 TAPI 3.0 中新增的LINEERR_constants时,必须使用新消息更新 Tapierr.mc 文件。

要求

要求
TAPI 版本
需要 TAPI 2.0 或更高版本
标头
Tapi.h

另请参阅

LINEADDRESSCAPS

LINEDEVCAPS

LINEDEVSTATUS

lineGetLineDevStatus

lineInitialize

lineInitializeEx

lineOpen

lineShutdown