lineSwapHold 函式 (tapi.h)
lineSwapHold 函式會交換指定的使用中呼叫,並在諮詢保留時使用指定的呼叫。
語法
LONG lineSwapHold(
HCALL hActiveCall,
HCALL hHeldCall
);
參數
hActiveCall
使用中呼叫的句柄。 應用程式必須是呼叫的擁有者。 hActiveCall 的呼叫狀態必須連線。
hHeldCall
諮詢通話的句柄。 應用程式必須是呼叫的擁有者。 hHeldCall 的呼叫狀態可以是 onHoldPendingTransfer、onHoldPendingConference 或 onHold。
傳回值
如果函式是以異步方式完成,則傳回正要求標識碼,如果發生錯誤,則傳回負錯誤號碼。 如果函式成功或發生錯誤,則對應LINE_REPLY訊息的 dwParam2 參數為零。 可能的傳回值為:
LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_NOTOWNER LINEERR_UNINITIALIZED。
備註
在諮詢保留時,將作用中的通話交換,可讓應用程式在這兩個通話之間替代或切換。 這在呼叫等候中很常見。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |