次の方法で共有


lineClose 関数 (tapi.h)

lineClose 関数は、指定された開いている行デバイスを閉じます。

構文

LONG lineClose(
  HLINE hLine
);

パラメーター

hLine

閉じるオープンライン デバイスへのハンドル。 行が正常に閉じられた後、このハンドルは無効になります。

戻り値

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

LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL。

注釈

開いている行でアクティブな呼び出しがある間にアプリケーションが lineClose を呼び出した場合、これらの呼び出しのアプリケーションの所有権は取り消されます。 アプリケーションがこれらの呼び出しの唯一の所有者であった場合、呼び出しも削除されます。 アプリケーションでは、所有権を明示的に放棄したり、行を閉じる前にこれらの呼び出しを削除したりして、開いている行で所有する呼び出しを破棄することをお勧めします。

行が正常に閉じられた場合は、 オープン /クローズ変更の行状況を監視しているすべてのアプリケーションにLINE_LINEDEVSTATEメッセージが送信されます。 未処理の非同期応答は抑制されます。

サービス プロバイダーは、回線が開いているアプリケーションから回線デバイスを強制的に回収するのに役立つ、または必要な場合があります。 これは、アプリケーションがライン デバイスを長時間独占するのを防ぐのに役立ちます。 この場合、LINE_CLOSE メッセージがアプリケーションに送信され、閉じられた回線デバイスの回線ハンドルが指定されます。

lineOpen 関数は、呼び出し元のアプリケーションにリソースを割り当てます。リソースが使用できない場合、アプリケーションは行を開けなくなります。 そのため、回線デバイス (発信呼び出しなど) のみを使用するアプリケーションは、回線を閉じてリソースを解放し、他のアプリケーションが回線を開くことを許可する必要があります。

要件

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

こちらもご覧ください

基本的なテレフォニー サービス リファレンス

LINE_CLOSE

LINE_LINEDEVSTATE

TAPI 2.2 リファレンスの概要

lineOpen