cancelIoEx 函数 (ioapiset.h)
标记指定文件句柄的任何未完成的 I/O 操作。 函数仅取消当前进程中的 I/O 操作，而不管哪个线程创建了 I/O 操作。
语法
BOOL CancelIoEx(
[in] HANDLE hFile,
[in, optional] LPOVERLAPPED lpOverlapped
);
参数
[in] hFile
文件的句柄。
[in, optional] lpOverlapped
指向包含用于异步 I/O 的数据的 OVERLAPPED 数据结构的指针。
如果此参数为 NULL，则会取消 hFile 参数的所有 I/O 请求。
如果此参数非 NULL，则只有为具有指定 lpOverlapped 重叠结构的文件发出的特定 I/O 请求被标记为已取消，这意味着可以取消一个或多个请求，而 CancelIo 函数将取消文件句柄上所有未完成的请求。
返回值
如果该函数成功，则返回值为非零值。 已成功请求取消操作，用于取消由指定文件句柄的调用进程发出的所有挂起 I/O 操作。 应用程序不得释放或重复使用与取消的 I/O 操作关联的 OVERLAPPED 结构，除非操作已完成。 线程可以使用 GetOverlappedResult 函数来确定 I/O 操作本身的完成时间。
如果函数失败，则返回值为 0（零）。 若要获得更多的错误信息，请调用 GetLastError 函数。
如果此函数找不到取消请求，则返回值为 0 (零 ) ，GetLastError 返回 ERROR_NOT_FOUND。
注解
CancelIoEx 函数允许取消调用线程以外的线程中的请求。 CancelIo 函数仅取消调用 CancelIo 函数的同一线程中的请求。 CancelIoEx 仅取消句柄上的未完成 I/O，它不会更改句柄的状态；这意味着不能依赖于句柄的状态，因为无法知道操作是成功完成还是已取消。
如果指定的文件句柄有任何挂起的 I/O 操作正在进行，则 CancelIoEx 函数会将其标记为取消。 大多数类型的操作都可以立即取消；其他操作可以在实际取消并通知调用方之前继续完成。 CancelIoEx 函数不会等待所有取消的操作完成。
如果文件句柄与完成端口相关联，则成功取消同步操作时，I/O 完成数据包不会排队到该端口。 对于仍处于挂起状态的异步操作，取消操作会将 I/O 完成数据包排在队列中。
正在取消的操作以三种状态之一完成：必须检查完成状态才能确定完成状态。 三种状态为：
- 操作正常完成。 即使已取消操作，也会发生这种情况，因为取消请求可能尚未及时提交以取消操作。
- 该操作已取消。 GetLastError 函数返回ERROR_OPERATION_ABORTED。
- 操作失败，出现另一个错误。 GetLastError 函数返回相关的错误代码。
| 技术 | 支持 |
|---|---|
| 服务器消息块 (SMB) 3.0 协议 | 是 |
| SMB 3.0 透明故障转移 (TFO) | 是 |
| 具有横向扩展文件共享的 SMB 3.0 (SO) | 是 |
| 群集共享卷文件系统 (CSV) | 是 |
| 弹性文件系统 (ReFS) | 是 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | ioapiset.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |