TSPI_lineClose関数 (tspi.h)
TSPI_lineClose関数は、デバイスで未処理のすべての呼び出しと非同期操作を完了または中止した後に、指定されたオープンライン デバイスを閉じます。
構文
LONG TSPIAPI TSPI_lineClose(
HDRVLINE hdLine
);
パラメーター
hdLine
閉じる行に対するサービス プロバイダーのハンドル。 行が正常に閉じられた後、このハンドルは無効になります。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL。
注釈
サービス プロバイダーは、すべての非同期操作の完了を報告する必要があります。 未処理 の 非同期操作がある行に対してTSPI_lineCloseが呼び出されると、このプロシージャが返される前に、適切な結果またはエラー コードで操作が完了したと報告されます。
回線上のアクティブな呼び出しにも同様の要件があります。 未処理の操作は、適切な結果またはエラー コードで完了したと報告する必要があります。 アクティブな呼び出しは、必要に応じて削除する必要があり、この動作が LINEDEVCAPS 構造体のLINEDEVCAPFLAGS_CLOSEDROP ビットによって示された場合も削除する必要があります。
このプロシージャが戻った後、サービス プロバイダーは、回線または回線上の呼び出しに htCall をそれ以上報告する必要はありません。 回線と回線の呼び出しに対するサービス プロバイダーのハンドルが "無効" になります。
サービス プロバイダーは、回線が開いている間に予約した共有不可能なリソースを放棄する必要があります。 たとえば、comm ポートとモデムを介してアクセスされた回線を閉じると、comm ポートが閉じられ、もう一度他のアプリケーションで使用できるようになります。
サービス プロバイダーは、この関数呼び出しに応答して LINE_LINEDEVSTATE メッセージを発行しません。これは、行が閉じられ、その状態の変更に関心がなくなったためです。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |