PHONEERR_ 常量

这是在电话设备上调用操作时实现可以返回的错误代码列表。 请参阅各个函数说明，以确定每个函数可以返回的错误代码。

PHONEERR_ALLOCATED

已分配指定的资源。

PHONEERR_BADDEVICEID

指定的设备标识符无效或范围外。

PHONEERR_DISCONNECTED

呼叫已断开连接。

PHONEERR_INCOMPATIBLEAPIVERSION

应用程序请求了电话 API 实现或相应服务提供商不支持的 API 版本或版本范围。

PHONEERR_INCOMPATIBLEEXTVERSION

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

PHONEERR_INIFILECORRUPT

由于Telephon.ini文件中的内部不一致或格式问题，TAPI 无法正确读取和理解它。

PHONEERR_INUSE

设备当前正在使用中。 无法配置设备。

PHONEERR_INVALAPPHANDLE

应用程序的指定使用句柄或注册句柄无效。

PHONEERR_INVALAPPNAME

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

PHONEERR_INVALBUTTONLAMPID

指定的按钮/灯标识符在范围外或无效。

PHONEERR_INVALBUTTONMODE

按钮模式参数无效。

PHONEERR_INVALBUTTONSTATE

按钮状态参数无效。

PHONEERR_INVALDATAID

指定的数据标识符无效。

PHONEERR_INVALDEVICECLASS

指定的手机不支持指示的设备类。

PHONEERR_INVALEXTVERSION

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

PHONEERR_INVALHOOKSWITCHDEV

hookswitch 设备参数无效。

PHONEERR_INVALHOOKSWITCHMODE

hookswitch 模式参数无效。

PHONEERR_INVALLAMPMODE

指定的灯模式参数无效。

PHONEERR_INVALPARAM

参数（如行、列值或窗口句柄）无效或超过范围。

PHONEERR_INVALPHONEHANDLE

指定的设备句柄无效。

PHONEERR_INVALPHONESTATE

对于所请求的操作，电话设备未处于有效状态。

PHONEERR_INVALPOINTER

一个或多个指定的指针参数无效。

PHONEERR_INVALPRIVILEGE

dwPrivilege 参数无效。

PHONEERR_INVALRINGMODE

环形模式参数无效。

PHONEERR_NODEVICE

指定的设备标识符（以前有效）不再被接受，因为自上次初始化 TAPI 以来，关联的设备已从系统中删除，或者以初始化时未检测到的方式损坏。

PHONEERR_NODRIVER

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

PHONEERR_NOMEM

内存不足，无法完成请求的操作，或者无法分配或锁定内存。

PHONEERR_NOTOWNER

应用程序对指定的电话设备没有所有者权限。

PHONEERR_OPERATIONFAILED

操作因未指定的原因而失败。

PHONEERR_OPERATIONUNAVAIL

操作不可用。

PHONEERR_REINIT

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

PHONEERR_REQUESTOVERRUN

已超出未完成电话请求的最大数量。

PHONEERR_RESOURCEUNAVAIL

由于资源过度，操作无法完成。

PHONEERR_STRUCTURETOOSMALL

指定的手机上限结构太小。

PHONEERR_UNINITIALIZED

该操作是在调用 phoneInitialize， phoneInitializeEx 的任何应用程序之前调用 的。

备注

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

如果应用程序收到错误返回，但未专门处理 (（例如由特定于设备的扩展) 定义的错误），则应将错误视为) 未指定原因的PHONEERR_OPERATIONFAILED (。

要求

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

请参阅

phoneInitialize

phoneInitializeEx

phoneOpen

phoneShutdown