Share via

TSPI_lineCloseCall関数 (tspi.h)

  • [アーティクル]

TSPI_lineCloseCall関数は、呼び出しで未処理のすべての非同期操作を完了または中止した後、呼び出しの割り当てを解除します。

構文

LONG TSPIAPI TSPI_lineCloseCall(
  HDRVCALL hdCall
);

パラメーター

hdCall

閉じる呼び出しに対するサービス プロバイダーのハンドル。 呼び出しが正常に終了すると、このハンドルは無効になります。 呼び出し状態には任意の状態を指定できます。

戻り値

関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。

LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL。

注釈

サービス プロバイダーは、非同期操作の完了を報告する必要があります。 未処理 の 非同期操作がある呼び出しに対してTSPI_lineCloseCallが呼び出された場合、このプロシージャが戻る前に、操作が適切な結果またはエラー コードで完了したと報告する必要があります。 このプロシージャが戻った後、サービス プロバイダーは呼び出しに関するそれ以上のイベントを報告する必要はありません。 回線のサービス プロバイダーのハンドルと、その行での呼び出しが "無効" になります。

サービス プロバイダーが TSPI_lineMakeCall 関数の呼び出しからエラーを同期的に返す場合、TAPI は TSPI_lineCloseCall を呼び出しません。 ただし、サービス プロバイダーが TSPI_lineMakeCall によって開始された非同期操作からエラーを返した場合、TAPI は TSPI_lineCloseCall を呼び出します。

TSPI_lineCloseCall時に行にアクティブな呼び出しがある 場合、この動作が LINEDEVCAPS 構造体のLINEDEVCAPFLAGS_CLOSEDROP ビットによって示される場合は、呼び出しを削除する必要があります。

サービス プロバイダーは、別のハンドセットを持つパーティ回線の状況など、呼び出しの別のエージェント共有制御があると判断できる場合、サービス プロバイダーは、強制的にドロップするのではなく、他のエージェントへの呼び出しパスを制御できます。

特別な状況を除き、この関数は常に成功するはずです。 ほとんどの呼び出し元は、発生したエラーを補正できないため、リターン コードを無視する可能性があります。 指定された戻り値は、開発診断の目的で、他の何よりもアドバイザリです。

この関数は、この呼び出しのハンドルを持つ最後のアプリケーションが lineDeallocateCall を実行するときに呼び出されます。

要件

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

こちらもご覧ください

LINEDEVCAPS

TSPI_lineMakeCall