QOSCancel 函数 (qos2.h)

QOSCancel 函数取消挂起的重叠操作，如 QOSSetFlow。

语法

ExternC BOOL QOSCancel(
  [in] HANDLE       QOSHandle,
  [in] LPOVERLAPPED Overlapped
);

[in] QOSHandle

[in] Overlapped

指向要取消的操作中使用的 OVERLAPPED 结构的指针。

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

如果函数失败，返回值为 0。要获得更多的错误信息，请调用 GetLastError。下面是一些可能的错误代码。

返回代码	说明
ERROR_INVALID_HANDLE	QOSHandle 参数无效。
ERROR_INVALID_PARAMETER	重叠参数无效。
ERROR_NOT_ENOUGH_MEMORY	内存分配失败。
ERROR_NO_SYSTEM_RESOURCES	资源不足，无法执行该操作。
ERROR_IO_DEVICE	由于出现 I/O 设备错误，因此无法执行该请求。
ERROR_DEVICE_REINITIALIZATION_NEEDED	由于硬件错误，指示的设备需要重新初始化。应用程序应清理并再次调用 QOSCreateHandle 。
ERROR_ADAP_HDW_ERR	网络适配器硬件出错。

永远不会使用 NULL重叠参数调用此函数。

成功取消的操作完成正常完成机制，并返回 ERROR_OPERATION_ABORTED 作为其完成返回代码。

使用 QOSCloseHandle 关闭句柄将自动中止使用该句柄发出的所有挂起操作。如果在 QOSCancel 仍在进行时关闭句柄，调用将以 ERROR_OPERATION_ABORTED 作为返回代码完成。