Функция CancelSynchronousIo

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

Синтаксис

BOOL WINAPI CancelSynchronousIo(
  __in  HANDLE hThread
);

Параметры

hThread

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

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

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

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

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

Замечания

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

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

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

Смотри также

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

Размещение и совместимость CancelSynchronousIo
К Windows Vista Да
л Windows XP Нет
и Windows 2000 Professional Нет
е Windows NT Workstation Нет
н Windows Me Нет
т Windows 98 Нет
  Windows 95 Нет
 
С Windows Server 2008 Да
е Windows Server 2003 Нет
р Windows 2000 Server Нет
в Windows NT Server Нет
е    
р    
Используемая библиотека Kernel32.lib
Используемая DLL kernel32.dll
Заголовочный файл  
- объявлено в Winbase.h
- включено в -
Unicode Нет
Замечания по платформе Не имеется

 

 

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

Hosted by uCoz