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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemprov.h (include Wbemidl.h)
Biblioteca	Wbemuuid.lib
DLL	Fastprox.dll

Confira também

IWbemEventConsumerProvider

IWbemUnboundObjectSink