CancelSynchronousIo 函数

  • 项目

将指定线程发出的挂起同步 I/O 操作标记为已取消。

语法

BOOL WINAPI CancelSynchronousIo(
  _In_ HANDLE hThread
);

参数

hThread[in]

线程的句柄。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为 0 (零) 。 若要获取扩展错误信息，请调用 GetLastError 函数。

如果此函数找不到取消请求，则返回值为 0 (零) ， GetLastError 返回 ERROR_NOT_FOUND。

备注

调用方必须具有 THREAD_TERMINATE 访问权限。

如果指定线程有任何挂起的 I/O 操作正在进行中， 则 CancelSynchronousIo 函数将其标记为取消。 大多数类型的操作都可以立即取消;其他操作可以在实际取消并通知调用方之前继续完成。 CancelSynchronousIo 函数不会等待所有取消的操作完成。 有关详细信息，请参阅 I/O 完成/取消指南。

正在取消的操作以三种状态之一完成：必须检查完成状态才能确定完成状态。 这三种状态为：

  • 操作正常完成。 即使已取消操作，也会发生这种情况，因为取消请求可能尚未及时提交以取消操作。
  • 该操作已取消。 GetLastError 函数返回ERROR_OPERATION_ABORTED。
  • 操作失败，出现另一个错误。 GetLastError 函数返回相关的错误代码。

在Windows 8和Windows Server 2012中，以下技术支持此功能。

技术 支持
服务器消息块 (SMB) 3.0 协议 是
SMB 3.0 透明故障转移 (TFO) 是
具有横向扩展文件共享的 SMB 3.0 (SO) 是
群集共享卷文件系统 (CsvFS) 是
弹性文件系统 (ReFS) 是

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 IoAPI.h (包括 Windows.h) ;
Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista 上的 WinBase.h (包括 Windows.h)
库 Kernel32.lib
DLL Kernel32.dll

另请参阅

CancelIo

CancelIoEx

文件管理功能

同步和异步 I/O