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

참고 항목

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery