次の方法で共有


lineDrop 関数 (tapi.h)

lineDrop 関数は、指定された呼び出しを破棄または切断します。 アプリケーションには、通話切断の一部として送信するユーザーとユーザーの情報を指定するオプションがあります。

構文

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

パラメーター

hCall

破棄する呼び出しを処理します。 アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態は、アイドル状態を除く任意の状態にすることができます。

lpsUserUserInfo

呼び出し切断の一部としてリモート パーティに送信されるユーザーとユーザーの情報を含む文字列へのポインター。 ユーザーとユーザーの情報を送信しない場合は、このポインターを NULL のままに できます。 ユーザーユーザー情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照)。 必要に応じて、ユーザーユーザー情報のプロトコル識別子フィールドは lpsUserUserInfo によって指されるバッファーの最初のバイトとして表示され、 dwSize では を考慮する必要があります。

dwSize

lpsUserUserInfo 内のユーザーユーザー情報のサイズ (バイト単位)。 lpsUserUserInfoNULL の場合、ユーザーユーザー情報は呼び出し元に送信されません。dwSize は無視されます。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応するLINE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。 可能な戻り値は次のとおりです。

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

注釈

lineDrop を呼び出すと、関連する呼び出しにも影響を受ける場合があります。 たとえば、電話会議を削除すると、参加しているすべての通話を削除できます。 LINE_CALLSTATE メッセージは、呼び出し状態が影響を受けるすべての呼び出しに対してアプリケーションに送信されます。 通常、ドロップされた呼び出しは アイドル 状態に遷移します。 オファリング状態の呼び出しで lineDrop を呼び出すと、呼び出しが拒否されます。 すべての電話ネットワークでこの機能が提供されるわけではありません。

保留 状態の 呼び出しは、通常、 接続 状態に戻ります。 電話会議のために第三者へのコンサルテーション コールを削除するとき、または以前に確立された電話会議で第三者を削除する場合、プロバイダー (およびスイッチ) は会議ブリッジを解放し、通話を通常の 2 者通話に戻すことができます。 この場合、 hConfCallアイドル 状態に遷移し、残りの唯一の参加している呼び出しは 接続 状態に遷移します。 一部のスイッチでは、もう一方の呼び出しが自動的に "保留" されます。

アプリケーションには、ドロップ時にユーザーとユーザーの情報を送信するオプションがあります。 ユーザーとユーザーの情報を送信できる場合でも、ネットワークがこの情報をリモート パーティに配信する保証はありません。

複数のパーティが呼び出し中の場合、さまざまなブリッジまたはパーティ回線の構成では、 lineDrop が実際に通話をクリアしない可能性があります。 たとえば、ブリッジされた状況では、コール上の他のステーションのステータスが制御される可能性があるため、 lineDrop 操作が実際にコールをドロップしない可能性があります。代わりに、他のステーションで 接続 されたままの場合は、呼び出しを単にLINECONNECTEDMODE_INACTIVE モードに変更できます。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

ドロップの概要

補助回線サービス関数

TAPI 2.2 リファレンスの概要

セッションの終了の概要