lineHold 函式 (tapi.h)

發行項
03/05/2024

lineHold 函式會將指定的呼叫置於保留狀態。

語法

LONG lineHold(
  HCALL hCall
);

參數

hCall

要保留之呼叫的句柄。應用程式必須是呼叫的擁有者。 hCall 的呼叫狀態必須連線。

傳回值

如果函式是以異步方式完成，則傳回正向要求標識符，如果發生錯誤，則傳回負錯誤號碼。如果函式成功或發生錯誤，則對應LINE_REPLY訊息的 dwParam2 參數為零。可能的傳回值為：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_NOTOWNER LINEERR_UNINITIALIZED。

備註

暫停通話會暫時中斷連線，讓應用程式使用線路裝置進行撥打或接聽其他通話。 lineHold 函式會執行所指定呼叫 (的所謂的「硬式保存」，而不是「諮詢呼叫」) 。固定保留通話通常無法轉移或包含在通話中，但諮詢通話可以。諮詢通話是使用 lineSetupTransfer、 lineSetupConference或 linePrepareAddToConference 起始。

成功保留通話之後，呼叫狀態通常會轉換成 onHold。保留的呼叫是由 lineUnhold擷取。當呼叫處於保留狀態時，應用程式可以接收有關保留呼叫狀態變更的 LINE_CALLSTATE 訊息。例如，如果保留方停止回應，呼叫狀態可以轉換為 已中斷連線。

在橋接的情況下， LineHold 作業可能實際上不會保留通話，因為通話上的其他月台狀態可以控管 (例如，嘗試在其他月台參與時「保留」通話) ;相反地，呼叫可以變更為LINECONNECTEDMODE_INACTIVE模式，如果呼叫保留在其他 站臺上 。