TSPI_lineRemoveFromConference函式 (tspi.h)

發行項
03/08/2023

TSPI_lineRemoveFromConference函式會從目前所屬的電話會議中移除指定的通話。會議通話中的剩餘通話不會受到影響。

語法

LONG TSPIAPI TSPI_lineRemoveFromConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

參數

dwRequestID

非同步要求的識別碼。

hdCall

要從會議中移除之通話的控制碼。 hdCall的通話狀態可以會議。

傳回值

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

這項作業會移除目前屬於會議通話的派對。成功移除呼叫之後，可以使用其控制碼進一步操作呼叫。這項作業的可用性及其結果可能會受限於許多實作中。例如，在許多實作中，只有最近新增的派對可以從會議中移除，而移除的通話可能會自動卸載， (變成閒置) 。服務提供者在 LINEDEVCAPS 中指出其功能，與從會議中移除通話的可用效果有關。

如果支援從會議中移除參與者，服務提供者必須在LINEADDRESSCAPS的dwRemoveFromConfState成員中指出從會議中移除通話轉換的通話狀態。