|
CancelIO
[New - Windows NT]
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
| );
|
|
Parameters
hFile
Handle to a file. The function cancels all pending I/O operations for this
file handle.
Return Values
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.
Remarks
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.
See Also
CreateFile, DeviceIoControl, LockFileEx, ReadDirectoryChangesW, ReadFile, ReadFileEx, WriteFile, WriteFileEx
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
