The CancelIo function cancels all pending input and output (I/O) operations that were issued by the calling thread for the specified file handle. The function does not cancel I/O operations issued for the file handle by other threads.
BOOL CancelIo(
HANDLE hFile |
// file handle for which to cancel I/O |
); |
If the function succeeds, the return value is nonzero All pending I/O operations issued by the calling thread for the file handle were successfully canceled.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
If there are any I/O operations in progress for the specified file handle, and they were issued by the calling thread, the CancelIo function cancels them.
Note that the I/O operations must have been issued as overlapped I/O. If they were not, the I/O operations would not have returned to allow the thread to call the CancelIo function. Calling the CancelIo function with a file handle that was not opened with FILE_FLAG_OVERLAPPED does nothing.
All I/O operations that are canceled will complete with the error ERROR_OPERATION_ABORTED. All completion notifications for the I/O operations will occur normally.
CreateFile, DeviceIoControl, LockFileEx, ReadDirectoryChangesW, ReadFile, ReadFileEx, WriteFile, WriteFileEx
See:
file: /Techref/os/win/api/win32/func/src/f04_5.htm, 2KB, , updated: 2001/6/26 09:35, local time: 2024/11/7 09:17,
18.207.160.209:LOG IN ©2024 PLEASE DON'T RIP! THIS SITE CLOSES OCT 28, 2024 SO LONG AND THANKS FOR ALL THE FISH!
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://www.piclist.com/techref/os/win/api/win32/func/src/f04_5.htm"> CancelIo</A> |
Did you find what you needed? |
PICList 2024 contributors:
o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr. |
Welcome to www.piclist.com! |
.