IWbemEventSink-Schnittstelle (wbemprov.h)
Die IWbemEventSink-Schnittstelle initiiert die Kommunikation mit einem Ereignisanbieter mithilfe eines eingeschränkten Abfragesatzes. Diese Schnittstelle erweitert IWbemObjectSink und bietet neue Methoden für Sicherheit und Leistung. Weitere Informationen zur Verwendung dieser Schnittstelle finden Sie unter Schreiben eines Ereignisanbieters und Schützen von WMI-Ereignissen.
Vererbung
Die IWbemEventSink-Schnittstelle erbt von der IUnknown-Schnittstelle . IWbemEventSink verfügt auch über folgende Membertypen:
Methoden
Die IWbemEventSink-Schnittstelle weist diese Methoden auf.
| IWbemEventSink::GetRestrictedSink Die IWbemEventSink::GetRestrictedSink-Methode ruft eine eingeschränkte Ereignissenke ab. Eine eingeschränkte Ereignissenke filtert eine Teilmenge der Ereignisse, die in der Registrierung des Ereignisanbieters definiert sind. |
| IWbemEventSink::IsActive Die IWbemEventSink::IsActive-Methode wird vom Anbieter verwendet, um zu bestimmen, ob interesse an den Ereignissen besteht, die die Senke filtert. |
| IWbemEventSink::SetBatchingParameters Die IWbemEventSink::SetBatchingParameters-Methode wird verwendet, um die maximale Ereignispuffergröße und den zugehörigen Verarbeitungslatenzwert festzulegen. |
| IWbemEventSink::SetSinkSecurity Wird verwendet, um einen Sicherheitsdeskriptor (SD) auf einer Senke für alle ereignisse festzulegen, die durchlaufen werden. |
Hinweise
Führen Sie beim Implementieren einer Ereignisabonnementsenke (IWbemObjectSink oder IWbemEventSink) keinen Aufruf von WMI aus den Methoden für das Senkenobjekt aus. Beispielsweise kann der Aufruf von IWbemServices::CancelAsyncCall zum Kündigen der Senke innerhalb einer Implementierung von IWbemEventSink::SetSinkSecurity zu Konflikten mit dem WMI-Zustand führen. Legen Sie zum Kündigen eines Ereignisabonnements ein Flag fest, und rufen Sie IWbemServices::CancelAsyncCall aus einem anderen Thread oder Objekt auf. Für Implementierungen, die sich nicht auf eine Ereignissenke beziehen, z. B. Objekt-, Enumerations- und Abfrageabrufe, können Sie Rückrufe an WMI ausführen.
Senkenimplementierungen sollten die Ereignisbenachrichtigung innerhalb von 100 ms verarbeiten, da der WMI-Thread, der die Ereignisbenachrichtigung übermittelt, keine anderen Aufgaben ausführen kann, bis das Senkenobjekt die Verarbeitung abgeschlossen hat. Wenn die Benachrichtigung einen großen Verarbeitungsumfang erfordert, kann die Senke eine interne Warteschlange für einen anderen Thread verwenden, um die Verarbeitung auszuführen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wbemprov.h (include Wbemidl.h) |