TSPI_lineBlindTransfer函式 (tspi.h)

TSPI_lineBlindTransfer函式會對指定的目的地位址執行指定呼叫的盲目或單一步驟傳輸。

語法

LONG TSPIAPI TSPI_lineBlindTransfer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

參數

dwRequestID

異步要求的標識碼。

hdCall

服務提供者對要轉移之呼叫的句柄。 hdCall 的呼叫狀態可以連線。

lpszDestAddress

以 Null 終止的 Unicode 字串指標，識別要傳送呼叫的位置。 目的地位址會使用標準可撥號號碼格式。

dwCountryCode

目的地的國家或地區代碼。 實作應該使用此項目來選取目的地位址的呼叫進度通訊協定。 如果指定 0 的值，服務提供者應該使用預設值。 呼叫此函式時，TAPI 不會驗證 dwCountryCode 。

傳回值

如果發生錯誤，則傳回 dwRequestID 或錯誤號碼。 如果函式成功，則對應ASYNC_COMPLETION的 lResult 實際參數為零;如果發生錯誤，則為錯誤號碼。 可能的傳回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESS、LINEERR_OPERATIONFAILED、LINEERR_ADDRESSBLOCKED、LINEERR_RESOURCEUNAVAIL LINEERR_INVALCOUNTRYCODE。

備註

如果服務提供者傳回LINEERR_INVALADDRESS，則不會執行撥號。

盲目轉移與諮詢轉移不同，因為TAPI不會看到任何諮詢電話。 一般而言，在盲目傳輸成功完成之後，指定的呼叫會從其開啟的行中清除，並轉換為 閑置 狀態。 服務提供者的呼叫句柄必須在傳輸完成之後保持有效。 TAPI 會導致此句柄在使用 TSPI_lineCloseCall 不再對已轉移 的呼叫感興趣時失效。

規格需求

另請參閱

ASYNC_COMPLETION

LINE_CALLSTATE

TSPI_lineCloseCall