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

另請參閱

LINE_REPLY

增補線路服務函式

TAPI 2.2 參考概觀