IWbemEventSink interface (wbemprov.h)
The IWbemEventSink interface initiates communication with an event provider using a restricted set of queries. This interface extends IWbemObjectSink, providing new methods dealing with security and performance. For more information about using this interface, see Writing an Event Provider and Securing WMI Events.
Inheritance
The IWbemEventSink interface inherits from the IUnknown interface. IWbemEventSink also has these types of members:
Methods
The IWbemEventSink interface has these methods.
| IWbemEventSink::GetRestrictedSink The IWbemEventSink::GetRestrictedSink method retrieves a restricted event sink. A restricted event sink is one which filters a subset of the events defined in the event provider's registration. |
| IWbemEventSink::IsActive The IWbemEventSink::IsActive method is used by the provider to determine if there is interest in the events that the sink is filtering. |
| IWbemEventSink::SetBatchingParameters The IWbemEventSink::SetBatchingParameters method is used to set the maximum event buffer size and its associated processing latency value. |
| IWbemEventSink::SetSinkSecurity Used to set a security descriptor (SD) on a sink for all the events passing through. |
Remarks
When implementing an event subscription sink (IWbemObjectSink or IWbemEventSink), do not call into WMI from within the methods on the sink object. For example, calling IWbemServices::CancelAsyncCall to cancel the sink from within an implementation of IWbemEventSink::SetSinkSecurity can interfere with the WMI state. To cancel an event subscription, set a flag and call IWbemServices::CancelAsyncCall from another thread or object. For implementations that are not related to an event sink, such as object, enum, and query retrievals, you can call back into WMI.
Sink implementations should process the event notification within 100 MSEC because the WMI thread that delivers the event notification cannot do other work until the sink object has completed processing. If the notification requires a large amount of processing, the sink can use an internal queue for another thread to handle the processing.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | wbemprov.h (include Wbemidl.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for