lineBlindTransfer 函式會對指定的目的地地址執行指定呼叫的盲目或單一步驟傳輸。
語法
LONG lineBlindTransferA(
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 解除分配其句柄。
注意
tapi.h 標頭會將lineBlindTransfer定義為別名,根據UNICODE預處理器常數的定義,自動選取此函式的ANSI或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |