lineRedirect 函式會將指定的供應專案呼叫重新導向至指定的目的地位址。
語法
LONG lineRedirectW(
HCALL hCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
參數
hCall
要重新導向的呼叫句柄。 應用程式必須是呼叫的擁有者。 hCall 的呼叫狀態必須 供應專案。
lpszDestAddress
目的地地址的指標。 這會遵循標準可撥號號碼格式。
dwCountryCode
呼叫重新導向至之合作對象的國家/地區代碼。 如果指定了 0 值，則實作會使用預設值。
傳回值
如果函式是以異步方式完成，則傳回正要求標識碼，如果發生錯誤，則傳回負錯誤號碼。 如果函式成功，則對應 LINE_REPLY 訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。 可能的傳回值為：
LINEERR_INVALADDRESS、LINEERR_NOTOWNER、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALCOUNTRYCODE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。
言論
通話重新導向可讓應用程式將供應專案呼叫轉移至另一個位址，而不需要先接聽電話。 通話重新導向與呼叫轉接不同，因為呼叫轉接是由參數執行，而不需要應用程式參與;重新導向可以依呼叫方式由應用程式執行，例如，由呼叫端標識碼信息驅動。 這與轉接通話不同，因為轉接通話需要先接聽通話。
成功重新導向通話之後，呼叫通常會轉換成閑置。
除了重新導向來電之外，應用程式可以選擇使用 lineAccept來接受通話、使用 lineDrop拒絕通話，或使用 lineAnswer接聽電話。 這些作業的可用性取決於裝置功能。
注意
tapi.h 標頭會將 lineRedirect 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| 標頭 | tapi.h |
| 連結庫 | Tapi32.lib |
| DLL | Tapi32.dll |