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 |
헤더 |
|
IDL |
|
DLL |
|
CLSID |
CLSID_SWbemSink |
IID |
IID_ISWbemSink |