Metodo IWbemUnboundObjectSink::IndicateToConsumer (wbemprov.h)

Il metodo IWbemUnboundObjectSink::IndicateToConsumer viene chiamato da WMI per recapitare effettivamente eventi a un consumer. Da un punto di vista dell'implementazione , IndicateToConsumer contiene il codice per l'elaborazione di eventi ricevuti dal sink.

Sintassi

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

Parametri

[in] pLogicalConsumer

Puntatore all'oggetto consumer logico per il quale viene recapitato questo set di oggetti.

[in] lNumObjects

Numero di oggetti recapitati nella matrice che segue.

[in] apObjects

Puntatore a una matrice di istanze IWbemClassObject che rappresentano gli eventi recapitati. Poiché ogni oggetto nella matrice corrisponde a un evento separato, un'implementazione di IndicateToConsumer deve trattare ogni oggetto separatamente.

Valore restituito

Questo metodo restituisce WBEM_S_NO_ERROR se riuscito. In caso contrario, l'implementazione deve restituire un codice di errore appropriato.

Commenti

WMI ottiene in genere il puntatore IWbemUnboundObjectSink per un particolare consumer logico da un provider consumer di eventi che implementa l'interfaccia IWbemEventConsumerProvider . Windows Management chiama quindi IndicateToConsumer per recapitare gli oggetti evento effettivi.

La maggior parte delle implementazioni di IndicateToConsumer presuppone che la notifica sia asincrona. Per supportare la notifica sincrona, un sink deve completare l'elaborazione eventi in meno di 20 millisecondi. I provider di consumer di eventi estremamente veloci che supportano la notifica sincrona non devono contenere il puntatore all'interfaccia IWbemClassObject o incrementare il conteggio dei riferimenti del puntatore in IndicateToConsumer. Se IndicateToConsumer richiede l'oggetto di classe definito da IWbemClassObject oltre la durata della chiamata IndicateToConsumer , eseguire una copia dell'oggetto. Tuttavia, se è necessario avere accesso a lungo termine alle informazioni a cui fa riferimento il puntatore IWbemClassObject , è consigliabile che il provider consumer di eventi non supporti la notifica sincrona. I provider di consumer di eventi indicano il tipo di notifica che supportano al termine della registrazione.

Requisiti

Vedi anche

IWbemEventConsumerProvider

IWbemUnboundObjectSink