TSPI_lineHold函式 (tspi.h)

發行項
08/26/2023

TSPI_lineHold函式會保留指定的呼叫。

語法

LONG TSPIAPI TSPI_lineHold(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

參數

dwRequestID

非同步要求的識別碼。

hdCall

要保留之呼叫的服務提供者控制碼。 hdCall的撥號狀態可以連線。

傳回值

傳回 dwRequestID，如果發生錯誤，則傳回錯誤號碼。如果函式成功，則對應ASYNC_COMPLETION的lResult實際參數為零，如果發生錯誤，則為錯誤號碼。可能的傳回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

暫停通話會暫時中斷連線，讓 TAPI 使用線路裝置進行撥打或接聽其他通話。 TSPI_lineHold 會執行指定通話的 硬式保存 ，而不是 諮詢通話。固定保留通話通常無法轉移或包含在通話中，而諮詢通話也可以。會使用 TSPI_lineSetupTransfer、 TSPI_lineSetupConference或 TSPI_linePrepareAddToConference來起始諮詢通話。

成功保留通話之後，撥號狀態通常會轉換為 onHold。保留的呼叫是透過 TSPI_lineUnhold擷取。當通話處於保留狀態時，服務提供者可以傳送有關保留撥號狀態變更的 LINE_CALLSTATE 訊息。例如，如果保留方停止回應，則撥號狀態可以轉換為 已中斷連線，而服務提供者可以傳送指出新狀態的LINE_CALLSTATE訊息。