ClearCommError

通信エラーに関する情報を取得し、通信デバイスの現在のステータスを報告する。

ClearCommError hFile, lpErrors, lpStat

hFile : [intptr] 通信デバイスへのハンドル。CreateFile 関数がこのハンドルを返す。
lpErrors : [var] 
lpStat : [var] デバイスのステータス情報を受け取る COMSTAT 構造体へのポインタ。このパラメータが NULL の場合、ステータス情報は返されない。

(プラグイン / モジュール : kernel32.dll)

解説

通信エラーに関する情報を取得し、通信デバイスの現在のステータスを報告する。

[戻り値]
関数が成功した場合、戻り値はゼロ以外。関数が失敗した場合、戻り値はゼロ。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
通信ポートがセットアップ時に DCB 構造体の fAbortOnError メンバーを TRUE
でセットアップされている場合、通信エラーが発生すると通信ソフトウェアはその通信ポート上のすべての読み書き操作を終了させる。アプリケーションが
ClearCommError 関数を呼んで通信エラーを承認するまで、新しい読み書き操作は受け付けられない。ClearCommError
関数は lpStat パラメータが指すステータスバッファに、hFile パラメータで指定された通信デバイスの現在のステータスを格納する。

情報