LINEERR_常數

發行項
06/13/2023

以下是在行、位址或呼叫上叫用作業時，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 版本或版本範圍與 Telephony API 實作和對應的服務提供者不相容或無法支援。

LINEERR_INCOMPATIBLEEXTVERSION

應用程式要求延伸模組版本範圍無效或無法由對應的服務提供者支援。

LINEERR_INIFILECORRUPT

由於內部不一致或格式化問題，所以 TAPI 無法正確讀取或理解Telephon.ini檔案。例如，Telephon.ini檔案的 [位置]、[卡片] 或 [國家/地區] 區段可能已損毀或不一致。

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

在登錄的 [Card] 區段中，找不到 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的位設定為 0，並將lineGetLineDevStatus函式所傳回LINEDEVSTATUS結構的dwDevStatusFlags成員中的值LINEDEVSTATUSFLAGS_INSERVICE設定為 0。

LINEERR_INVALLOCATION

在登錄的 [Locations] 區段中，找不到 dwLocation 中指定的永久位置識別碼。

LINEERR_INVALMEDIALIST

指定的媒體清單無效。

LINEERR_INVALMEDIAMODE

要監視的媒體類型清單 (模式) 包含不正確資訊、指定的媒體類型參數無效，或服務提供者不支援指定的媒體類型。行上支援的媒體類型會列在LINEDEVCAPS結構的dwMediaModes成員中。

LINEERR_INVALMESSAGEID

dwMessageID中指定的數位超出LINEADDRESSCAPS結構中dwNumCompletionMessages成員所指定的範圍。

LINEERR_INVALPARAM

參數所指向的參數或結構包含不正確資訊、國家或地區代碼無效、視窗控制碼無效，或指定的轉寄清單參數包含不正確資訊。

LINEERR_INVALPARKID

駐留識別碼無效。

LINEERR_INVALPARKMODE

指定的駐留模式無效。

LINEERR_INVALPASSWORD

指定的密碼不正確，而且要求的動作尚未執行。

LINEERR_INVALPASSWORD

應用程式使用了不正確密碼。此值只會公開給交涉 TAPI 2.0 版或更新版本的應用程式。

LINEERR_INVALPOINTER

(一或多個指定的指標參數，例如 lpCallList、 lpdwAPIVersion、 lpExtensionID、 lpdwExtVersion、 lphIcon、 lpLineDevCaps和 lpToneList) 無效，或輸出參數的必要指標為 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

不支援多個實例的電話語音服務提供者會多次列在登錄的 [提供者] 區段中。應用程式應該建議使用者使用 Telephony 主控台來移除重複的驅動程式。

LINEERR_NOMULTIPLEINSTANCE

不允許此服務提供者的多個實例。

LINEERR_NOREQUEST

目前沒有指定模式的要求擱置中，或應用程式不再是指定要求模式的最高優先順序應用程式。

LINEERR_NOTOWNER

應用程式沒有指定呼叫的擁有者許可權。

LINEERR_NOTREGISTERED

應用程式未註冊為所指定要求模式的要求收件者。

LINEERR_OPERATIONFAILED

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

LINEERR_OPERATIONUNAVAIL

作業無法使用，例如指定裝置或指定的行。

LINEERR_RATEUNAVAIL

服務提供者目前沒有足夠的頻寬可供指定的速率使用。

LINEERR_REINIT

如果已要求 TAPI 重新初始化，例如，由於新增或移除電話語音服務提供者的結果，則lineInitialize、lineInitializeEx或lineOpen要求會遭到拒絕，並出現此錯誤，直到最後一個應用程式使用lineShutdown) 關閉其 API 的使用 (，此時新的設定會生效，而且再次允許應用程式呼叫lineInitialize 或 lineInitializeEx。

LINEERR_REINIT

應用程式嘗試初始化 TAPI 兩次。

LINEERR_REQUESTOVERRUN

比裝置可以處理的要求還多。

LINEERR_RESOURCEUNAVAIL

資源不足，無法完成作業。例如，因為動態資源過度認可，所以無法開啟行。

LINEERR_STRUCTURETOOSMALL

結構的 dwTotalSize 成員未指定足夠的記憶體來包含指定結構的固定部分。

LINEERR_TARGETNOTFOUND

找不到通話遞交的目標。如果具名應用程式未在lineOpen的dwPrivileges參數中開啟與 LINECALLPRIVILEGE_OWNER 位相同的行，就會發生此情況。或者，在媒體模式遞交的情況下，沒有任何應用程式在lineOpen的dwPrivileges 參數中開啟了與 dwPrivileges參數中的 LINECALLPRIVILEGE_OWNER 位相同的行，並在lineOpen的dwMediaModes參數中指定了dwMediaMode參數中指定的媒體類型。

LINEERR_TARGETSELF

叫用此作業的應用程式是間接遞交的目標。也就是說，TAPI 已判斷呼叫應用程式也是指定媒體類型的最高優先順序應用程式。

LINEERR_UNINITIALIZED

作業是在任何名為 lineInitialize 或 lineInitializeEx的應用程式之前叫用。

LINEERR_USERCANCELLED

使用者已取消通話。此值只會公開給交涉 TAPI 2.2 版或更新版本的應用程式。

LINEERR_USERUSERINFOTOOBIG

包含使用者資訊之字串超過 dwUUIAcceptSize、 dwUUIAnswerSize、 dwUUIDropSize、 dwUUIMakeCallSize或 dwUUISendUserInfoSize 成員中指定的位元組數目 上限，或包含使用者資訊之字串太長。

備註

透過 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

共用方式為

LINEERR_常數

備註

規格需求

另請參閱

意見反應

其他資源