14 сент. 2010 г.

CancelIo



Поддерживается начиная с Windows98
Функция CancelIo прекращает все ожидающие операции ввода и вывода (вв/выв), которые выдал вызывающий поток для указанного дескриптора файла. Функция не прекращает операции вв/выв, которые выдали другие потоки для дескриптора файла.


BOOL CancelIo(
  HANDLE hFile
);

Параметры:
hFileДескриптор файла. Функция прекращает все ожидающие операции вв/выв для этого дескриптора фала.

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