Функция 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 |
- |
|
Замечания по платформе |
Не имеется |