cancelSynchronousIo 函数 (ioapiset.h)

  • 项目

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

语法

BOOL CancelSynchronousIo(
  [in] HANDLE hThread
);

参数

[in] hThread

线程的句柄。

返回值

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

如果函数失败，则返回值为 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) 是
群集共享卷文件系统 (CSV) 是
弹性文件系统 (ReFS) 是

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 ioapiset.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

CancelIo

CancelIoEx

文件管理函数

同步和异步 I/O