IWbemEventProviderQuerySink::CancelQuery 메서드(wbemprov.h)
논리 이벤트 소비자가 Windows Management를 사용하여 관련 이벤트 쿼리 필터를 취소할 때마다 IWbemEventProviderQuerySink::CancelQuery 메서드를 호출합니다. CancelQuery 메서드는 이벤트 공급자가 관련 취소된 이벤트 쿼리 필터에 응답하는 방법을 결정합니다. WMI가 소비자로부터 이벤트 쿼리 필터에 대한 취소 알림을 검색할 때마다 WMI는 CancelQuery 를 호출하여 취소를 책임 있는 이벤트 공급자에게 에코합니다. 이벤트 공급자는 쿼리의 식별자를 검사하여 취소할 쿼리를 확인할 수 있습니다. 그런 다음 공급자는 취소에 따라 전송되는 이벤트를 수정합니다.
구문
HRESULT CancelQuery(
[in] unsigned long dwId
);
매개 변수
[in] dwId
취소된 쿼리의 식별자입니다. 이 식별자는 원래 이 인터페이스의 NewQuery 메서드에 의해 공급자에게 전달되었습니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT 를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.
설명
소비자가 새 이벤트 쿼리 필터를 등록할 때마다 Windows Management는 쿼리 식별자를 사용하여 IWbemEventProviderQuerySink::NewQuery 메서드를 호출합니다. 나중에 해당 쿼리가 등록 취소되면 더 이상 처리되지 않는 쿼리를 나타내는 이 메서드가 호출됩니다.
공급자는 이 메서드를 사용하여 내부적으로 이벤트 생성을 최적화합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wbemprov.h(Wbemidl.h 포함) |
| 라이브러리 | Wbemuuid.lib |
| DLL | Wbemsvc.dll |