__FilterToConsumerBinding-Klasse

Die __FilterToConsumerBinding-Systemklasse wird bei der Registrierung dauerhafter Ereignisconsumer verwendet, um eine Instanz von __EventConsumer mit einer Instanz von __EventFilter in Beziehung zu setzen. __FilterToConsumerBinding ist eine Zuordnungsklasse.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge aufgeführt, nicht in MOF-Reihenfolge.

Syntax

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

Member

Die __FilterToConsumerBinding-Klasse verfügt über die folgenden Membertypen:

• Eigenschaften

Eigenschaften

Die __FilterToConsumerBinding-Klasse hat die folgenden Eigenschaften.

Consumer

Datentyp: __EventConsumer

Zugriffstyp: Lesen/Schreiben

Qualifizierer: Key

Verweis auf eine Instanz von __EventConsumer, die den Objektpfad zu einem logischen Consumer, dem Empfänger eines Ereignisses, darstellt. Ein logischer Consumer ist ein Instanz einer Klasse, die von __EventConsumer abgeleitet wird.

CreatorSID

Datentyp: uint8-Array

Zugriffstyp: Lesen/Schreiben

Sicherheits-ID (SID), die den Benutzer, der die Bindung erstellt, eindeutig identifiziert. Je nach Betriebssystem speichert WMI die SID des Administrators oder die des Benutzers, der eine Instanz von __FilterToConsumerBinding erstellt. Weitere Informationen finden Sie unter Binden eines Ereignisfilters an einen logischen Consumer und Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern.

DeliverSynchronously

Datentyp: boolean (boolesch)

Zugriffstyp: Lesen/Schreiben

Veraltet. Verwenden Sie stattdessen die DeliveryQoS-Eigenschaft anstelle dieser Eigenschaft, denn wenn DeliverSynchronously auf TRUE festgelegt ist, wird die Einstellung der DeliveryQoS-Eigenschaft außer Kraft gesetzt.

DeliveryQoS

Datentyp: uint32

Zugriffstyp: Lesen/Schreiben

Dienstqualität für ein Abonnement. Wenn die DeliverSynchronously-Eigenschaft auf TRUE festgelegt ist, überschreibt sie die Einstellung der DeliveryQoS-Eigenschaft.

WMIMSG_FLAG_QOS_SYNCHRONOUS (0)

Synchrone Übermittlung

False. Das Ereignis wird synchron an den logischen Consumer übermittelt.

WMIMSG_FLAG_QOS_EXPRESS (1)

Schnellübermittlung

True. Das Ereignis wird asynchron an den logischen Consumer übermittelt.

Filter

Datentyp: __EventFilter

Zugriffstyp: Lesen/Schreiben

Qualifizierer: Key

Verweis auf eine Instanz von __EventFilter, die den Objektpfad zu einem Ereignisfilter darstellt, der eine Abfrage ist, die den Typ des zu empfangenden Ereignisses angibt.

MaintainSecurityContext

Datentyp: boolean (boolesch)

Zugriffstyp: Lesen/Schreiben

Falls TRUE, werden die Ereignisse im gleichen Sicherheitskontext übermittelt, in dem sich der Anbieter befand, als er sie bereitgestellt hat.

Hinweis

Nur ein als DLL implementierter Consumer (prozessinterner Consumer) kann Ereignisse im Sicherheitskontext des Anbieters empfangen. Weitere Informationen zu Prozessanbietern und Sicherheit finden Sie unter Anbieterhosting und Sicherheit. Weitere Informationen und Beispiele finden Sie unter Sicheres Empfangen von Ereignissen.

SlowDownProviders

Datentyp: boolean (boolesch)

Zugriffstyp: Lesen/Schreiben

Falls TRUE, werden Anbieter verlangsamt, wenn dieser Consumer nicht mithalten kann.

Bemerkungen

Die __FilterToConsumerBinding-Klasse wird von der __IndicationRelated-Klasse abgeleitet, die keine Eigenschaften aufweist.

Permanente Ereignisconsumer verwenden die __FilterToConsumerBinding-Systemklasse, um Ereignisfilter an endgültige Consumer zu binden. Nachdem Filter und Consumer miteinander verbunden wurden, kann WMI die dem Filter entsprechenden Ereignisse an den entsprechenden Consumer weiterleiten.

Beispiele

Das PowerShell-Beispiel Erstellen einer permanenten WMI-Ereignisregistrierung zum Überwachen von Dateien im TechNet-Katalog verwendet __FilterToConsumerBinding als Teil eines komplexen Skripts, um eine permanente WMI-Ereignisregistrierung einzurichten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Namespace	Alle WMI-Namespaces

Weitere Informationen

__IndicationRelated

WMI-Systemklassen

Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern

Überwachen von Ereignissen

Erstellen eines Ereignisfilters

Schützen von WMI-Ereignissen