IWbemUnboundObjectSink::IndicateToConsumer-Methode (wbemprov.h)

Die IWbemUnboundObjectSink::IndicateToConsumer-Methode wird von WMI aufgerufen, um Tatsächlich Ereignisse an einen Consumer zu übermitteln. Aus Implementierungssicht enthält IndicateToConsumer den Code für die Verarbeitung von Ereignissen, die die Senke empfängt.

Syntax

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

Parameter

[in] pLogicalConsumer

Zeiger auf das logische Consumerobjekt, für das dieser Satz von Objekten übermittelt wird.

[in] lNumObjects

Anzahl der Objekte, die im folgenden Array übermittelt werden.

[in] apObjects

Zeiger auf ein Array von IWbemClassObject-Instanzen , die die übermittelten Ereignisse darstellen. Da jedes Objekt im Array einem separaten Ereignis entspricht, muss eine Implementierung von IndicateToConsumer jedes Objekt separat behandeln.

Rückgabewert

Diese Methode gibt bei erfolgreicher Ausführung WBEM_S_NO_ERROR zurück. Andernfalls sollte die Implementierung einen entsprechenden Fehlercode zurückgeben.

Hinweise

WMI ruft in der Regel den IWbemUnboundObjectSink-Zeiger für einen bestimmten logischen Consumer von einem Ereignisverbraucheranbieter ab, der die IWbemEventConsumerProvider-Schnittstelle implementiert. Anschließend ruft die Windows-Verwaltung IndicateToConsumer auf, um die tatsächlichen Ereignisobjekte bereitzustellen.

Die meisten Implementierungen von IndicateToConsumer gehen davon aus, dass die Benachrichtigung asynchron ist. Um synchrone Benachrichtigungen zu unterstützen, muss eine Senke die Ereignisverarbeitung in weniger als 20 Millisekunden abschließen. Extrem schnelle Ereignis-Consumeranbieter, die synchrone Benachrichtigungen unterstützen, dürfen nicht den Zeiger auf die IWbemClassObject-Schnittstelle enthalten oder die Zeigerverweisanzahl in IndicateToConsumer erhöhen. Wenn IndicateToConsumer das von IWbemClassObject definierte Klassenobjekt über die Lebensdauer des IndicateToConsumer-Aufrufs hinaus erfordert, erstellen Sie eine Kopie des Objekts. Wenn der IWbemClassObject-Zeiger jedoch langfristigen Zugriff auf die Informationen haben muss, wird empfohlen, dass der Ereignisverbraucheranbieter die synchrone Benachrichtigung nicht unterstützt. Ereignisverbraucheranbieter geben die Art der Benachrichtigung an, die sie unterstützen, wenn sie ihre Registrierung abschließen.

Anforderungen

Weitere Informationen

IWbemEventConsumerProvider

IWbemUnboundObjectSink