TSPI_lineRedirect函式 (tspi.h)
TSPI_lineRedirect函式會將指定的供應專案呼叫重新導向至指定的目的地位址。
語法
LONG TSPIAPI TSPI_lineRedirect(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
參數
dwRequestID
異步要求的標識碼。
hdCall
要重新導向之呼叫的句柄。 hdCall 的呼叫狀態可以提供。
lpszDestAddress
指定目的地位址之 Null 終止 Unicode 字串的指標。 這會遵循標準連結格式。
dwCountryCode
重新導向呼叫之合作對象的國家或地區代碼。 如果指定值為 0，實作會使用預設值。 呼叫此函式時，TAPI 不會驗證此參數。
傳回值
會傳回 dwRequestID，如果發生錯誤，則傳回錯誤號碼。 如果函式成功，則對應ASYNC_COMPLETION的 lResult 實際參數為零，如果發生錯誤，則為錯誤號碼。 可能的傳回值如下所示：
LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCOUNTRYCODE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS LINEERR_RESOURCEUNAVAIL。
備註
如果服務提供者傳回LINEERR_INVALADDRESS，則不會重新導向呼叫。
叫用此函式時，服務提供者會將供應專案呼叫變更為另一個位址，而不需要先接聽呼叫。 通話重新導向與通話轉接不同，因為呼叫轉接是由交換器執行，而不需要呼叫月臺介入;重新導向可以依呼叫方式由用戶端應用程式進行，例如由呼叫端標識碼信息驅動。 其與通話轉移不同，因為轉移通話需要先接聽通話。
成功重新導向通話之後，通話通常會轉換為 閑置。 服務提供者會使用 LINE_CALLSTATE 訊息指出新的狀態。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |