__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
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 |