lineDrop 関数 (tapi.h)

[アーティクル]
03/09/2024

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

構文

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

パラメーター

hCall

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

lpsUserUserInfo

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

dwSize

lpsUserUserInfo 内のユーザーユーザー情報のサイズ (バイト単位)。 lpsUserUserInfo が NULL の場合、ユーザーユーザー情報は呼び出し元に送信されません。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 モードに変更できます。