Функция 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) произойдут как обычно.

Смотри также

Размещение и совместимость 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		-
Замечания по платформе		Не имеется