Método IWbemUnboundObjectSink::IndicateToConsumer (wbemprov.h)

O método IWbemUnboundObjectSink::IndicateToConsumer é chamado pelo WMI para realmente entregar eventos a um consumidor. Do ponto de vista da implementação, IndicateToConsumer contém o código para processar eventos que o coletor recebe.

Sintaxe

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

Parâmetros

[in] pLogicalConsumer

Ponteiro para o objeto de consumidor lógico para o qual esse conjunto de objetos é entregue.

[in] lNumObjects

Número de objetos entregues na matriz a seguir.

[in] apObjects

Ponteiro para uma matriz de instâncias IWbemClassObject que representam os eventos entregues. Como cada objeto na matriz corresponde a um evento separado, uma implementação de IndicateToConsumer deve tratar cada objeto separadamente.

Retornar valor

Esse método retornará WBEM_S_NO_ERROR se tiver êxito. Caso contrário, a implementação deverá retornar um código de erro apropriado.

Comentários

O WMI normalmente obtém o ponteiro IWbemUnboundObjectSink para um consumidor lógico específico de um provedor de consumidor de eventos que implementa a interface IWbemEventConsumerProvider . Em seguida, o Gerenciamento do Windows chama IndicateToConsumer para entregar os objetos de evento reais.

A maioria das implementações de IndicateToConsumer pressupõe que a notificação seja assíncrona. Para dar suporte à notificação síncrona, um coletor deve concluir o processamento de eventos em menos de 20 milissegundos. Provedores de consumidores de eventos extremamente rápidos que dão suporte à notificação síncrona não devem manter o ponteiro para a interface IWbemClassObject ou incrementar a contagem de referência de ponteiro em IndicateToConsumer. Se IndicateToConsumer exigir o objeto de classe definido por IWbemClassObject além do tempo de vida da chamada IndicateToConsumer , faça uma cópia do objeto. No entanto, se precisar haver acesso de longo prazo às informações apontadas pelo ponteiro IWbemClassObject , é recomendável que o provedor do consumidor de eventos não dê suporte à notificação síncrona. Os provedores de consumidores de eventos indicam o tipo de notificação ao qual dão suporte quando concluem o registro.

Requisitos

Confira também

IWbemEventConsumerProvider

IWbemUnboundObjectSink