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

另請參閱

LINE_REPLY

增補行服務函式

TAPI 2.2 參考概觀

傳輸概觀

lineDeallocateCall