Функция CancelIo

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

Синтаксис

BOOL CancelIo(
  HANDLE hFile  // дескриптор файла
);

Параметры

hFile

[in]  Дескриптор файла. Функция отменяет все ждущие обработки операции ввода-вывода (I/O) для этого дескриптора файла.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение - не нуль. Все ждущие обработки операции ввода-вывода (I/O), порождаемые вызывающим потоком для дескриптора файла были успешно отменены.

Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.

Замечания

Если есть какие-либо операции ввода-вывода (I/O) исполняемые в текущий момент для указанного дескриптора файла, и они были порождены вызывающим потоком, функция CancelIo отменяет их.

Обратите внимание! на то, что операции ввода-вывода (I/O) должны быть порождены как асинхронные операции. Если они не такие, то операции ввода-вывода (I/O) не возвратят значение, чтобы дать возможность потоку вызывать функцию CancelIo. Вызов функции CancelIo с дескриптором файла, который не был открыт с флажком  FILE_FLAG_OVERLAPPED, не делает ничего.

Все операции ввода-вывода (I/O), которые отменены, закончат работу с ошибкой ERROR_OPERATION_ABORTED. Все уведомления о завершении операций ввода-вывода (I/O) произойдут  как обычно.

Смотри также 

Обзор Управление файламиФункции, используемые для файлового ввода-вывода (I/O), CreateFile, DeviceIoControl, LockFileEx, ReadDirectoryChangesW, ReadFile, ReadFileEx, WriteFile, WriteFileEx

Размещение и совместимость  CancelIo

К

Windows XP

Да 

л

Windows 2000 Professional

Да

и

Windows NT Workstation

Да версии 4.0

е

Windows Me

Да

н

Windows 98

Да

т

Windows 95

Да

 
С

Windows Server 2003

Да

е Windows 2000 Server Да
р Windows NT Server Да версии  4.0
в    
е    
р    

Используемая библиотека

Kernel32.lib

Используемая DLL -
 Заголовочный файл  

- объявлено в

Winbase.h

 - включено в

Windows.h

 Unicode

-

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz