QOSCancel 함수(qos2.h)

QOSCancel 함수는 QOSSetFlow와 같은 보류 중인 겹치는 작업을 취소합니다.

구문

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

[in] QOSHandle

QOSCreateHandle에서 반환된 QOS 하위 시스템에 대한 핸들입니다.

[in] Overlapped

취소할 작업에 사용되는 OVERLAPPED 구조체에 대한 포인터입니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 몇 가지 가능한 오류 코드는 다음과 같습니다.

반환 코드	설명
ERROR_INVALID_HANDLE	QOSHandle 매개 변수가 잘못되었습니다.
ERROR_INVALID_PARAMETER	Overlapped 매개 변수가 잘못되었습니다.
ERROR_NOT_ENOUGH_MEMORY	메모리 할당에 실패했습니다.
ERROR_NO_SYSTEM_RESOURCES	작업을 수행할 리소스가 부족합니다.
ERROR_IO_DEVICE	I/O 디바이스 오류 때문에 요청을 수행할 수 없는 경우
ERROR_DEVICE_REINITIALIZATION_NEEDED	하드웨어 오류로 인해 표시된 디바이스를 다시 초기화해야 합니다. 애플리케이션은 클린 QOSCreateHandle을 다시 호출해야 합니다.
ERROR_ADAP_HDW_ERR	네트워크 어댑터 하드웨어 오류가 발생했습니다.

이 함수는 NULLOverlapped 매개 변수를 사용하여 호출되지 않습니다.

성공적으로 취소된 작업은 정상적인 완료 메커니즘을 완료하고 완료 반환 코드로 ERROR_OPERATION_ABORTED 반환합니다.

QOSCloseHandle을 사용하여 핸들을 닫으면 해당 핸들에서 발급된 보류 중인 모든 작업이 자동으로 중단됩니다. QOSCancel이 아직 진행 중인 동안 핸들이 닫히면 ERROR_OPERATION_ABORTED 반환 코드로 호출이 완료됩니다.