Функция CancelSynchronousIo

Отмечает синхронные операции ожидающие ввода/вывода (I/O), которые были запущены указанным потоком как отмененные.

Синтаксис

Параметры

Дескриптор потока.

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

Если функция завершается успешно, возвращаемое значение - не нуль.

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

Если эта функция не может найти запрос на отмену ввода/вывода, возвращаемое значение 0 (нуль), а GetLastError возвращает значение ERROR_NOT_FOUND.

Замечания

Вызывающая программа должна иметь право THREAD_TERMINATE.

Если имеются какие-либо ожидающие завершения операции ввода/вывода (I/O) исполняемые в текущий момент заданным потоком, функция CancelSynchronousIo отмечает их для отмены. Большинство типов операций, может быть отменено немедленно; другие операции могут продолжиться до завершения перед тем, как они фактически будут отменены, а вызывающая программа получает уведомление. Функция CancelSynchronousIo не ждет завершения всех отмененных операций. Дополнительную информацию смотри в статье Завершение ввода-вывода / Рекомендации по отмене ввода/вывода.

Отменяющаяся операция завершает работу в одном из трех состояний; Вы должны проверить состояние завершения, чтобы определить состояние завершения. Этими тремя состояниями являются:

• Операция завершилась нормально. Это может произойти даже тогда, когда операция отменялась, потому что запрос отмены, возможно, не был представлен вовремя, чтобы отменить операцию.
• Операция отменялась. Функция GetLastError возвращает значение ERROR_OPERATION_ABORTED.
• Операция завершалась с другой ошибкой. Функция GetLastError возвращает соответствующий код ошибки.

Смотри также

Обзор Управление файлами, Функции, для файлового ввода-вывода (I/O), CancelIo, CancelIoEx