Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

__FilterToConsumerBinding class

The __FilterToConsumerBinding system class is used in the registration of permanent event consumers to relate an instance of the __EventConsumer to an instance of __EventFilter.__FilterToConsumerBinding is an association class.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class __FilterToConsumerBinding : __IndicationRelated
{
  __EventConsumer REF Consumer;
  uint8           CreatorSID[];
  boolean         DeliverSynchronously = False;
  uint32          DeliveryQoS;
  __EventFilter   REF Filter;
  boolean         MaintainSecurityContext = False;
  boolean         SlowDownProviders = False;
};

Members

The __FilterToConsumerBinding class has these types of members:

Properties

The __FilterToConsumerBinding class has these properties.

Consumer
Data type: __EventConsumer
Access type: Read/write
Qualifiers: Key

Reference to an instance of __EventConsumer that represents the object path to a logical consumer, the recipient of an event. A logical consumer is an instance of a class derived from __EventConsumer.

CreatorSID
Data type: uint8 array
Access type: Read/write

Security identifier (SID) that uniquely identifies the user who created the binding. Depending on the operating system, WMI stores the Administrator SID or the SID of the user that creates an instance of __FilterToConsumerBinding. For more information, see Binding an Event Filter with a Logical Consumer and Monitoring and Responding to Events with Standard Consumers.

DeliverSynchronously
Data type: boolean
Access type: Read/write

Obsolete. Instead use the DeliveryQoS property in place of this property, because if DeliverSynchronously is set to True it overrides the setting of the DeliveryQoS property.

DeliveryQoS
Data type: uint32
Access type: Read/write

Quality of service for a subscription. If the DeliverSynchronously property is set to True, it overrides the setting of the DeliveryQoS property.

ValueMeaning
WMIMSG_FLAG_QOS_SYNCHRONOUS
0

Synchronous delivery

False. The event is delivered to the logical consumer synchronously.

WMIMSG_FLAG_QOS_EXPRESS
1

Express delivery

True. The event is delivered to the logical consumer asynchronously.

 

Filter
Data type: __EventFilter
Access type: Read/write
Qualifiers: Key

Reference to an instance of __EventFilter that represents the object path to an event filter which is a query that specifies the type of event to be received.

MaintainSecurityContext
Data type: boolean
Access type: Read/write

If True, the events are delivered in the same security context that the provider was in when it provided them.

Note  Only a consumer implemented as a DLL (an in-process consumer) can receive events in the security context of the provider. For more information about in-process providers and security, see Provider Hosting and Security. For more information and examples, see replace:Receiving Events Securely.

SlowDownProviders
Data type: boolean
Access type: Read/write

If True, providers are slowed down if this consumer cannot keep up.

Remarks

The __FilterToConsumerBinding class is derived from __IndicationRelated, which has no properties.

Permanent event consumers use the __FilterToConsumerBinding system class to bind event filters to final consumers. After the filter and consumer are bound together, WMI can forward events that match the filter to the corresponding consumer.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Namespace

all WMI namespaces

See also

WMI System Classes
Monitoring and Responding to Events with Standard Consumers
Monitoring Events
Creating an Event Filter
Securing WMI Events

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.