lineRedirect 函式 (tapi.h)
lineRedirect 函式會將指定的供應專案呼叫重新導向至指定的目的地位址。
語法
LONG lineRedirect(
HCALL hCall,
LPCSTR 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接聽通話。 這些作業的可用性取決於裝置功能。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |