次の方法で共有

TSPI_lineDrop 関数 (tspi.h)

  • [アーティクル]

TSPI_lineDrop関数は、指定した呼び出しを削除または切断します。 ユーザーとユーザーの情報は、必要に応じて通話切断の一部として送信できます。 この関数は、アプリケーションからいつでも呼び出すことができます。 TSPI_lineDropが返された場合、呼び出しはアイドル状態である必要があります。

構文

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

破棄する呼び出しに対するサービス プロバイダーのハンドル。 hdCall の呼び出し状態は、アイドル状態を除く任意の状態にすることができます。

lpsUserUserInfo

このポインターは、 dwSize が 0 以外の場合にのみ有効です。 呼び出し切断の一部としてリモート パーティに送信されるユーザーユーザー情報を含む null で終わる文字列へのポインターを指定します。 ユーザーとユーザーの情報を送信しない場合、このポインターは NULL です。 ユーザーとユーザーの情報は、基になるネットワークでサポートされている場合にのみ送信されます ( LINEDEVCAPS を参照してください)。

dwSize

lpsUserUserInfo のユーザー ユーザー情報のサイズ (バイト単位)。 lpsUserUserInfo が NULL の場合、dwSize は無視されます。

戻り値

エラーが発生した場合は 、dwRequestID またはエラー番号を返します。 関数が成功した場合は対応するASYNC_COMPLETIONの lResult 実際のパラメーターは 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG、LINEERR_OPERATIONUNAVAIL。

注釈

呼び出しの現在の状態で呼び出しの削除が許可されていない場合、サービス プロバイダーは LINEERR_INVALCALLSTATE を返します。

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

通話を破棄する場合は、転送または電話会議の確立中に確立された相談呼び出しで、 OnHoldPending 状態に置かれた元の通話が再接続され、通常は 接続された 通話状態に再び入ります。

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

メモ 複数の関係者が通話中の場合、さまざまなブリッジ回線またはパーティ回線の構成では、 TSPI_lineDrop が実際に通話をクリアできない可能性があります。
 

要件

要件 値
対象プラットフォーム Windows
ヘッダー tspi.h

こちらもご覧ください

ASYNC_COMPLETION

LINEDEVCAPS

LINE_CALLSTATE

TSPI_lineGetDevCaps