lineBlindTransfer 函式 (tapi.h)
lineBlindTransfer 函式會對指定的目的地位址執行指定呼叫的盲目或單一步驟傳輸。
語法
LONG lineBlindTransfer(
HCALL hCall,
LPCSTR lpszDestAddress,
DWORD dwCountryCode
);
參數
hCall
要轉移之呼叫的控制碼。 應用程式必須是此呼叫的擁有者。 必須連線hCall的撥號狀態。
lpszDestAddress
TBD
dwCountryCode
目的地的國家或地區代碼。 實作會使用此位址來選取目的地位址的呼叫進度通訊協定。 如果指定 0 的值,則會使用服務提供者所定義的預設呼叫進度通訊協定。
傳回值
如果函式是以非同步方式完成,則傳回正要求識別碼,如果發生錯誤,則傳回負錯誤號碼。 如果函式成功,則對應LINE_REPLY訊息的dwParam2參數為零,如果發生錯誤,則為負錯誤號碼。 可能的傳回值為:
LINEERR_INVALCALLHANDLE、LINEERR_INVALCOUNTRYCODE、LINEERR_INVALCALLSTATE、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL、LINEERR_NOTOWNER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESS、LINEERR_UNINITIALIZED、LINEERR_ADDRESSBLOCKED、LINEERR_OPERATIONFAILED。
備註
如果傳回LINEERR_INVALADDRESS,則不會發生撥號。
盲目轉移與諮詢轉移不同,因為應用程式不會看到任何諮詢通話。 在盲目傳輸成功完成之後,指定的呼叫通常會從應用程式的行中清除,並轉換為 閒置 狀態。
完成傳輸之後,應用程式的呼叫控制碼仍有效。 當應用程式不再對已轉移的呼叫感興趣時,必須使用 lineDeallocateCall 解除配置其控制碼。
規格需求
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |