CancelIo

指定ファイルに対して呼び出しスレッドが発行した、保留中の入出力 (I/O) 操作すべてをキャンセルする。

CancelIo hFile

hFile : [intptr] ファイルへのハンドル。関数はこのファイルハンドルに対する保留中の I/O 操作をすべてキャンセルする。

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

解説

指定ファイルに対して呼び出しスレッドが発行した、保留中の入出力 (I/O) 操作すべてをキャンセルする。

[戻り値]
関数が成功した場合、戻り値はゼロ以外。指定ファイルハンドルに対し呼び出しスレッドが発行した保留中の I/O
操作すべてのキャンセル要求が正常に送信された。スレッドは GetOverlappedResult 関数を使って I/O
操作自体が完了した時点を判定できる。関数が失敗した場合、戻り値はゼロ (0)。拡張エラー情報を取得するには GetLastError
関数を呼ぶ。

[備考]
指定ファイルハンドルに対して進行中の I/O 操作があり、それらが呼び出しスレッドによって発行されたものであれば、CancelIo
関数がそれらをキャンセルする。CancelIo はハンドル上の未完了 I/O
のみをキャンセルし、ハンドルの状態は変更しない。つまり、操作が正常に完了したのかキャンセルされたのかは分からないので、ハンドルの状態に依存してはならない。I/O
操作はオーバーラップ I/O として発行されなければならない。そうでないと I/O 操作は戻らず、スレッドが CancelIo
を呼び出すことができない。FILE_FLAG_OVERLAPPED で開かれていないファイルハンドルに対して CancelIo
を呼んでも何も起こらない。キャンセルされたすべての I/O 操作は ERROR_OPERATION_ABORTED エラーで完了し、I/O
操作の完了通知は通常どおりに発生する。Windows 8 および Windows Server 2012
では、この関数は以下の技術でサポートされている。
（以下省略）

情報