术语 | cancelio |
释义 | CancelIo 语法: C++ BOOL WINAPI CancelIo( __in HANDLE hFile ); CancelIo功能 取消所有未输入和输出(I / O)的是由指定的文件调用线程发出的行动。该函数不取消I / O操作的问题,其他线程的文件句柄。 要取消的I / O操作另一个线程,使用CancelIoEx功能。 参数 hFile [in] 阿处理该文件。 该函数取消这个文件处理所有待处理的I / O操作。 返回值 如果函数成功,返回值为非零。所有待我取消操作/输出由指定的文件句柄调用线程发出的行动是成功的要求。该线程可以使用GetOverlappedResult函数来确定何时在I / O自己已经完成业务。 如果函数失败,返回值是零(0)。为了获得更多错误信息,调用GetLastError函数。 备注 如果有任何挂起的I / O操作在指定的文件处理进展,它们是由调用线程发出,CancelIo功能取消它们。 CancelIO取消/ O的句柄唯一悬而未决的我,它不会改变处理国家,这意味着您不能依靠的投诉,因为您不知道手术是否成功完成或取消状态。 在/ O操作必须发出重叠I I / O的如果不是,该I / O操作不回头,让这些线程调用CancelIo功能。调用的文件CancelIo函数句柄不FILE_FLAG_OVERLAPPED不执行任何操作打开。 所有I / O操作被取消完成与错误ERROR_OPERATION_ABORTED,并完成通知所有的I / O操作发生正常。 要求: 最低支持:client-Windows 2000专业版 最低支持server-Windows 2000服务器 HeaderWinBase.h(头文件:winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 CancelIoEx CancelSynchronousIo CreateFile 的DeviceIoControl 文件管理函数 LockFileEx ReadDirectoryChangesW ReadFile ReadFileEx 同步和异步I / O WriteFile WriteFileEx 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年9月3日 ==英文原文==CancelIo Function Cancels all pending input and output (I/O) operations that are issued by the calling thread for the specified file. The function does not cancel I/O operations that other threads issue for a file handle. To cancel I/O operations from another thread, use the CancelIoEx function. Syntax C++ BOOL WINAPI CancelIo( __in HANDLE hFile ); Parameters hFile [in] A handle to the file. The function cancels all pending I/O operations for this file handle. Return Value If the function succeeds, the return value is nonzero. The cancel operation for all pending I/O operations issued by the calling thread for the specified file handle was successfully requested. The thread can use the GetOverlappedResult function to determine when the I/O operations themselves have been completed. If the function fails, the return value is zero (0). To get extended error information, call the GetLastError function. Remarks If there are any pending I/O operations in progress for the specified file handle, and they are issued by the calling thread, the CancelIo function cancels them. CancelIO cancels only outstanding I/O on the handle, it does not change the state of the handle; this means that you cannot rely on the state of the handle because you cannot know whether the operation was completed successfully or canceled. The I/O operations must be issued as overlapped I/O. If they are not, the I/O operations do not return to allow the thread to call the CancelIo function. Calling the CancelIo function with a file handle that is not opened with FILE_FLAG_OVERLAPPED does nothing. All I/O operations that are canceled complete with the error ERROR_OPERATION_ABORTED, and all completion notifications for the I/O operations occur normally. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinBase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also CancelIoEx CancelSynchronousIo CreateFile DeviceIoControl File Management Functions LockFileEx ReadDirectoryChangesW ReadFile ReadFileEx Synchronous and Asynchronous I/O WriteFile WriteFileEx Send comments about this topic to Microsoft Build date: 9/3/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa363791(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。