ISWbemSink::Cancel 메서드

SWbemSink 개체의 Cancel 메서드는 이 개체 싱크와 연결된 모든 미해결 비동기 작업을 취소합니다.

이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.

구문

SWbemSink.Cancel()

매개 변수

이 메서드에는 매개 변수가 없습니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

오류 코드

Cancel 메서드가 완료되면 Err 개체에 아래 오류 코드 중 하나가 포함될 수 있습니다.

wbemErrFailed - 2147749889(0x80041001)

알 수 없는 오류입니다.

wbemErrOutOfMemory - 2147749894(0x80041006)

메모리가 부족하여 작업을 완료할 수 없습니다.

wbemErrTransportFailure - 2147749909(0x80041015)

네트워킹 오류가 발생하여 정상적으로 작동하지 않습니다.

wbemErrAccessDenied - 2147749891(0x80041003)

현재 또는 지정된 사용자 이름 및 암호가 잘못되었거나 연결할 권한이 없습니다.

설명

비동기 호출은 하나만 취소할 수 없습니다. 이 개체 싱크를 사용하는 여러 비동기 호출이 보류 중인 경우 이 메서드는 이 개체 싱크를 사용하여 모든 비동기 호출을 취소합니다. 다른 개체 싱크와 연결된 비동기 호출은 영향을 받지 않습니다.

비동기 작업을 취소하기 위해 이 싱크를 Nothing에 할당할 수 없습니다. WMI가 작업을 중단하고 연결된 리소스를 해제하도록 하려면 Cancel 메서드를 호출해야 합니다. 이는 쿼리와 같이 긴 비동기 작업 또는 ExecNotificationQueryAsync와 같이 완료되지 않는 작업에서 매우 중요합니다.

참고

비동기 콜백을 사용하면 인증되지 않은 사용자가 싱크에 데이터를 제공할 수 있습니다. 이로 인해 스크립트 및 애플리케이션에 보안 위험이 발생할 수 있습니다. 위험을 제거하려면 반동기 또는 동기 통신을 사용합니다. 자세한 내용은 메서드 호출을 참조하세요.

다음 예제에서는 비동기 호출을 취소하는 방법을 보여줍니다.

objwbemsink.Cancel()
set objwbemsink= Nothing

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSink

추가 정보

SWbemSink