lineDrop 函式 (tapi.h)

發行項
03/02/2024

lineDrop 函式會卸除或中斷指定的呼叫。應用程式可以選擇指定要在呼叫中斷連線期間傳輸的用戶用戶資訊。

語法

LONG lineDrop(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

參數

hCall

要卸除之呼叫的句柄。應用程式必須是呼叫的擁有者。 hCall 的呼叫狀態可以是閑置以外的任何狀態。

lpsUserUserInfo

字串的指標，其中包含要傳送至遠端合作物件做為呼叫中斷連線的一部分的用戶資訊。如果未傳送使用者使用者資訊，此指標可以保留 NULL 。只有在基礎網路支援時，用戶使用者資訊才會傳送 (請參閱 LINEDEVCAPS) 。如有需要，使用者使用者信息的通訊協議辨別子字段應該顯示為 lpsUserUserInfo 所指向之緩衝區的第一個字節，而且必須在 dwSize 中考慮。

dwSize

lpsUserInfo 中使用者使用者資訊的大小，以位元組為單位。如果 lpsUserUserInfo 為 NULL，則不會傳送使用者使用者資訊給呼叫方，而且會忽略 dwSize 。

傳回值

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

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

備註

叫用 lineDrop時，相關的呼叫有時也會受到影響。例如，卸除會議通話可能會卸除所有參與的個別通話。 LINE_CALLSTATE 訊息會傳送至應用程式，以取得所有呼叫狀態受到影響的呼叫。已卸除的呼叫通常會轉換成閑置狀態。在供應項目狀態的呼叫上叫用lineDrop會拒絕呼叫。並非所有電話網路都提供這項功能。

處於 onholdpending 狀態的呼叫通常會還原為連線狀態。當卸除對會議通話的第三方諮詢通話，或在先前建立的會議通話中移除第三方時，提供者 (並切換) 可以釋出會議網橋，並將通話還原回一般的兩方通話。如果是這種情況， hConfCall 會轉換為閒置狀態，而剩餘的參與呼叫會轉換為聯機狀態。有些參數會自動「取消保留」另一個呼叫。

應用程式可以選擇在卸除時傳送用戶用戶資訊。即使可以傳送使用者使用者資訊，也不保證網路會將此資訊傳遞給遠端合作物件。

當多方在通話時，在各種橋接或合作方線路設定中， lineDrop 可能不會實際清除通話。例如，在橋接的情況下， LineDrop 作業可能實際上不會卸除呼叫，因為通話上其他月臺的狀態可能會控管;相反地，呼叫可能會變更為LINECONNECTEDMODE_INACTIVE模式，如果它保留在其他 站臺上 。