IWbemUnboundObjectSink::IndicateToConsumer 메서드(wbemprov.h)

실제로 소비자에게 이벤트를 전달하기 위해 WMI에서 IWbemUnboundObjectSink::IndicateToConsumer 메서드를 호출합니다. 구현 관점에서 IndicateToConsumer 에는 싱크가 수신하는 이벤트를 처리하기 위한 코드가 포함되어 있습니다.

구문

HRESULT IndicateToConsumer(
  [in] IWbemClassObject *pLogicalConsumer,
  [in] long             lNumObjects,
  [in] IWbemClassObject **apObjects
);

매개 변수

[in] pLogicalConsumer

이 개체 집합이 전달되는 논리적 소비자 개체에 대한 포인터입니다.

[in] lNumObjects

다음 배열에 전달되는 개체의 수입니다.

[in] apObjects

전달된 이벤트를 나타내는 IWbemClassObject 인스턴스의 배열에 대한 포인터입니다. 배열의 각 개체는 별도의 이벤트에 해당하므로 IndicateToConsumer 의 구현은 각 개체를 개별적으로 처리해야 합니다.

반환 값

이 메서드는 성공하면 WBEM_S_NO_ERROR 반환합니다. 그렇지 않으면 구현에서 적절한 오류 코드를 반환해야 합니다.

설명

WMI는 일반적으로 IWbemEventConsumerProvider 인터페이스를 구현하는 이벤트 소비자 공급자로부터 특정 논리 소비자에 대한 IWbemUnboundObjectSink 포인터를 가져옵니다. 그런 다음 Windows Management는 IndicateToConsumer 를 호출하여 실제 이벤트 개체를 전달합니다.

대부분의 IndicateToConsumer 구현에서는 알림이 비동기라고 가정합니다. 동기 알림을 지원하려면 싱크가 20밀리초 이내에 이벤트 처리를 완료해야 합니다. 동기 알림을 지원하는 매우 빠른 이벤트 소비자 공급자는 IWbemClassObject 인터페이스에 대한 포인터를 보유하거나 IndicateToConsumer에서 포인터 참조 수를 증가시키지 않아야 합니다. IndicateToConsumer에서 IndicateToConsumer 호출의 수명을 초과하여 IWbemClassObject에 정의된 클래스 개체가 필요한 경우 개체의 복사본을 만듭니다. 그러나 IWbemClassObject 포인터가 가리키는 정보에 장기적으로 액세스해야 하는 경우 이벤트 소비자 공급자가 동기 알림을 지원하지 않는 것이 좋습니다. 이벤트 소비자 공급자는 등록을 완료할 때 지원하는 알림 유형을 나타냅니다.

요구 사항

추가 정보

IWbemEventConsumerProvider

IWbemUnboundObjectSink