网站首页  词典首页

请输入您要查询的函数:

 

术语 cancelsynchronousio
释义 CancelSynchronousIo
语法:
C++
BOOL WINAPI CancelSynchronousIo(
__in HANDLE hThread
);
CancelSynchronousIo功能
商标有待同步I / O是由指定的线程作为取消发行业务。
参数
hThread [in]
句柄到线程。
返回值
如果函数成功,返回值为非零。
如果函数失败,返回值为0(零)。为了获得更多错误信息,调用GetLastError函数。
如果这个功能无法找到要求取消,则返回值为0(零),GetLastError返回ERROR_NOT_FOUND。
备注
调用者必须有THREAD_TERMINATE访问权限。
如果有任何悬而未决的I / O在指定的线程进步行动,CancelSynchronousIo功能马克他们注销。大部分的业务类型可以立即取消,其他操作可以继续之前,完成对他们实际上取消了,来电通知。该CancelSynchronousIo函数不会等待所有取消操作完成。有关更多信息,请参见I / O完成/取消准则。
该行动被取消与三个状态之一,您必须检查完成状态,以确定的完成情况完成。这三个状态是:
该操作完成正常。可能发生这种情况,即使操作被取消,因为取消请求可能没有及时提交取消操作。
该操作被取消。 GetLastError函数返回ERROR_OPERATION_ABORTED。
经营失败的另一个错误。 GetLastError函数返回有关的错误代码。
要求:
client最低支持Vista
server最低支持 Windows Server 2008
HeaderWinBase.h
LibraryKernel32.lib
DLLKernel32.dll
参见
CancelIo
CancelIoEx
文件管理函数
同步和异步I / O
如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com)
生成日期:2009年9月3日
==英文原文==CancelSynchronousIo Function
Marks pending synchronous I/O operations that are issued by the specified thread as canceled.
Syntax
C++
BOOL WINAPI CancelSynchronousIo(
__in HANDLE hThread
);
Parameters
hThread [in]
A handle to the thread.
Return Value
If the function succeeds, the return value is nonzero.
If the function fails, the return value is 0 (zero). To get extended error information, call the GetLastError function.
If this function cannot find a request to cancel, the return value is 0 (zero), and GetLastError returns ERROR_NOT_FOUND.
Remarks
The caller must have the THREAD_TERMINATE access right.
If there are any pending I/O operations in progress for the specified thread, the CancelSynchronousIo function marks them for cancellation. Most types of operations can be canceled immediately; other operations can continue toward completion before they are actually canceled and the caller is notified. The CancelSynchronousIo function does not wait for all canceled operations to complete. For more information, see I/O Completion/Cancellation Guidelines .
The operation being canceled is completed with one of three statuses; you must check the completion status to determine the completion state. The three statuses are:
The operation completed normally. This can occur even if the operation was canceled, because the cancel request might not have been submitted in time to cancel the operation.
The operation was canceled. The GetLastError function returns ERROR_OPERATION_ABORTED.
The operation failed with another error. The GetLastError function returns the relevant error code.
Requirements
Minimum supported clientWindows Vista
Minimum supported serverWindows Server 2008
HeaderWinBase.h
LibraryKernel32.lib
DLLKernel32.dll
See Also
CancelIo
CancelIoEx
File Management Functions
Synchronous and Asynchronous I/O
Send comments about this topic to Microsoft
Build date: 9/3/2009
==原始网址==http://msdn.microsoft.com/en-us/library/aa363794(VS.85).aspx\n
随便看

 

windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。

 

Copyright © 2004-2023 Winrtm.com All Rights Reserved
京ICP备2021023879号-40 更新时间:2024/10/6 11:25:30