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

La méthode IWbemUnboundObjectSink ::IndicateToConsumer est appelée par WMI pour fournir des événements à un consommateur. Du point de vue de l’implémentation, IndiqueToConsumer contient le code pour le traitement des événements que le récepteur reçoit.

Syntaxe

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

Paramètres

[in] pLogicalConsumer

Pointeur vers l’objet consommateur logique pour lequel cet ensemble d’objets est fourni.

[in] lNumObjects

Nombre d’objets remis dans le tableau qui suit.

[in] apObjects

Pointeur vers un tableau d’instances IWbemClassObject qui représentent les événements remis. Étant donné que chaque objet du tableau correspond à un événement distinct, une implémentation d’IndicateToConsumer doit traiter chaque objet séparément.

Valeur retournée

Cette méthode retourne WBEM_S_NO_ERROR si elle réussit. Sinon, l’implémentation doit retourner un code d’erreur approprié.

Remarques

WMI obtient généralement le pointeur IWbemUnboundObjectSink pour un consommateur logique particulier auprès d’un fournisseur de consommateurs d’événements qui implémente l’interface IWbemEventConsumerProvider . Ensuite, Windows Management appelle IndicateToConsumer pour remettre les objets d’événement réels.

La plupart des implémentations d’IndicateToConsumer supposent que la notification est asynchrone. Pour prendre en charge la notification synchrone, un récepteur doit terminer le traitement des événements en moins de 20 millisecondes. Les fournisseurs de consommateurs d’événements extrêmement rapides qui prennent en charge la notification synchrone ne doivent pas contenir le pointeur vers l’interface IWbemClassObject ni incrémenter le nombre de références de pointeur dans IndicateToConsumer. Si IndicateToConsumer nécessite l’objet de classe défini par IWbemClassObject au-delà de la durée de vie de l’appel IndicateToConsumer , effectuez une copie de l’objet. Toutefois, s’il doit y avoir un accès à long terme aux informations pointées par le pointeur IWbemClassObject , il est recommandé que le fournisseur de consommateurs d’événements ne prend pas en charge la notification synchrone. Les fournisseurs de consommateurs d’événements indiquent le type de notification qu’ils prennent en charge lorsqu’ils terminent leur inscription.

Configuration requise

Voir aussi

IWbemEventConsumerProvider

IWbemUnboundObjectSink