lineClose 関数 (tapi.h)

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

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