PHONEERR_常數

這是在電話裝置上叫用作業時,實作可傳回的錯誤碼清單。 請參閱個別函式描述,以判斷每個函式可以傳回哪些錯誤碼。

PHONEERR_ALLOCATED

指定的資源已配置。

PHONEERR_BADDEVICEID

指定的裝置識別碼無效或超出範圍。

PHONEERR_DISCONNECTED

呼叫已中斷連線。

PHONEERR_INCOMPATIBLEAPIVERSION

應用程式要求無法由 Telephony 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

指定裝置的電話服務提供者發現其中一個元件在初始化時未偵測到,遺失或損毀。 建議使用者使用 Telephony 主控台來修正問題。

PHONEERR_NOMEM

記憶體不足,無法完成要求的作業,或無法配置或鎖定記憶體。

PHONEERR_NOTOWNER

應用程式沒有指定電話裝置的擁有者許可權。

PHONEERR_OPERATIONFAILED

作業因未指定的原因而失敗。

PHONEERR_OPERATIONUNAVAIL

作業無法使用。

PHONEERR_REINIT

如果已要求 TAPI 重新初始化, 例如,因為新增或移除電話語音服務提供者,然後phoneInitialize、phoneInitializeExphoneOpen要求會遭到拒絕,直到最後一個應用程式使用phoneShutdown) 關閉其 API 使用方式 (,此時新的組態會生效,而且再次允許應用程式呼叫phoneInitializephoneInitializeEx

PHONEERR_REQUESTOVERRUN

已超過未完成的電話要求數目上限。

PHONEERR_RESOURCEUNAVAIL

因為資源過度認可,所以無法完成作業。

PHONEERR_STRUCTURETOOSMALL

指定的手機上限結構太小。

PHONEERR_UNINITIALIZED

作業是在呼叫phoneInitialize、phoneInitializeEx的任何應用程式之前叫用。

備註

透過0xFFFFFFFF 0xC0000000的值適用于裝置特定延伸模組;保留0x80000000到0xBFFFFFFF的值;和 0x00000000透過0x7FFFFFFF做為要求識別碼。

如果應用程式收到錯誤傳回,表示它未特別處理 (,例如裝置特定擴充功能所定義的錯誤) ,它應該將錯誤視為PHONEERR_OPERATIONFAILED (,因為未指定的原因) 。

規格需求

需求
TAPI 版本
需要 TAPI 2.0 或更新版本
標頭
Tapi.h

另請參閱

phoneInitialize

phoneInitializeEx

phoneOpen

phoneShutdown