Поддерживается начиная с Windows98
Функция CancelIo прекращает все ожидающие операции ввода и вывода (вв/выв), которые выдал вызывающий поток для указанного дескриптора файла. Функция не прекращает операции вв/выв, которые выдали другие потоки для дескриптора файла.
BOOLCancelIo ( HANDLEhFile );
Параметры:
Дескриптор файла. Функция прекращает все ожидающие операции вв/выв для этого дескриптора фала. |
Возвращаемые значения:
При успешном завершении, функция возвращает ненулевое значение.
При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызовите GetLastError.
При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызовите GetLastError.
Замечания:
Если есть какие-либо операции вв/выв в обработке для указанного дескриптора файла, и они выданы вызывающим потоком, функция CancelIo прекращает их.
Операция, которая была успешно завершена, не стоит в очереди входа в порт завершения.
Операции вв/выв должны быть выданы как частично совпадающие вв/выв. Если нет, операции вв/выв не возвращают возможность потоку вызвать функцию CancelIo. Вызов функции CancelIo с дескриптором, который не открыт с флагом FILE_FLAG_OVERLAPPED ничего не дает.
Все операции вв/выв, которые полностью завершены с ошибкой ERROR_OPERATION_ABORTED, и всеми завершающими уведомлениями для операций вв/выв, происходят нормально.
Операция, которая была успешно завершена, не стоит в очереди входа в порт завершения.
Операции вв/выв должны быть выданы как частично совпадающие вв/выв. Если нет, операции вв/выв не возвращают возможность потоку вызвать функцию CancelIo. Вызов функции CancelIo с дескриптором, который не открыт с флагом FILE_FLAG_OVERLAPPED ничего не дает.
Все операции вв/выв, которые полностью завершены с ошибкой ERROR_OPERATION_ABORTED, и всеми завершающими уведомлениями для операций вв/выв, происходят нормально.
Смотрите также:
CreateFile, DeviceIoControl, LockFileEx, ReadDirectoryChangesW, ReadFile, ReadFileEx, WriteFile, WriteFileEx