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 函数返回相关的错误代码。
| 技术 | 支持 |
|---|---|
| 服务器消息块 (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 |