QOSCancel 函式 (qos2.h)

QOSCancel函式會解除擱置重迭的作業，例如QOSSetFlow。

語法

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

[in] QOSHandle

QOSCreateHandle所傳回之 QOS 子系統的控制碼。

[in] 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 。