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

WMI llama al método IWbemUnboundObjectSink::IndicateToConsumer para entregar eventos a un consumidor. Desde el punto de vista de la implementación, IndicateToConsumer contiene el código para procesar los eventos que recibe el receptor.

Sintaxis

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

Parámetros

[in] pLogicalConsumer

Puntero al objeto de consumidor lógico para el que se entrega este conjunto de objetos.

[in] lNumObjects

Número de objetos entregados en la matriz siguiente.

[in] apObjects

Puntero a una matriz de instancias IWbemClassObject que representan los eventos entregados. Dado que cada objeto de la matriz corresponde a un evento independiente, una implementación de IndicateToConsumer debe tratar cada objeto por separado.

Valor devuelto

Este método devuelve WBEM_S_NO_ERROR si se ejecuta correctamente. De lo contrario, la implementación debe devolver un código de error adecuado.

Comentarios

WMI obtiene normalmente el puntero IWbemUnboundObjectSink para un consumidor lógico determinado de un proveedor de consumidores de eventos que implementa la interfaz IWbemEventConsumerProvider . A continuación, administración de Windows llama a IndicateToConsumer para entregar los objetos de evento reales.

La mayoría de las implementaciones de IndicateToConsumer asumen que la notificación es asincrónica. Para admitir notificaciones sincrónicas, un receptor debe completar el procesamiento de eventos en menos de 20 milisegundos. Los proveedores de consumidores de eventos extremadamente rápidos que admiten notificaciones sincrónicas no deben contener el puntero a la interfaz IWbemClassObject o incrementar el recuento de referencias de puntero en IndicateToConsumer. Si IndicateToConsumer requiere el objeto de clase definido por IWbemClassObject más allá de la duración de la llamada a IndicateToConsumer , realice una copia del objeto. Sin embargo, si debe haber acceso a largo plazo a la información a la que apunta el puntero IWbemClassObject , se recomienda que el proveedor de consumidores de eventos no admita la notificación sincrónica. Los proveedores de consumidores de eventos indican el tipo de notificación que admiten cuando completan su registro.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemprov.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Fastprox.dll

Consulte también

IWbemEventConsumerProvider

IWbemUnboundObjectSink