Classe __FilterToConsumerBinding

La classe système __FilterToConsumerBinding est utilisée dans l’inscription des consommateurs d’événements permanents pour lier une instance de __EventConsumer à une instance de __EventFilter. __FilterToConsumerBinding est une classe d’association.

La syntaxe suivante est simplifiée à partir de code au format MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

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

Membres

La classe __FilterToConsumerBinding a ces types de membre :

• Propriétés

Propriétés

La classe __FilterToConsumerBinding a ces propriétés.

Consommateur

Type de données : __EventConsumer

Type d’accès : lecture/écriture

Qualificateurs : Clé

Référence à une instance de __EventConsumer qui représente le chemin d’accès de l’objet à un consommateur logique, le destinataire d’un événement. Un consommateur logique est une instance d’une classe dérivée de __EventConsumer.

CreatorSID

Type de données : tableau uint8

Type d’accès : lecture/écriture

Identificateur de sécurité (SID) qui identifie de manière unique l’utilisateur qui a créé la liaison. Selon le système d’exploitation, WMI stocke le SID d’administrateur ou le SID de l’utilisateur qui crée une instance de __FilterToConsumerBinding. Pour plus d'informations, voir Liaison d’un filtre d'événements à un consommateur logique et Monitoring des événements et réponse à ces derniers avec des consommateurs standard.

DeliverSynchronously

Type de données : booléen

Type d’accès : lecture/écriture

Obsolète. Utilisez plutôt la propriété DeliveryQoS à la place de cette propriété, car si DeliverSynchronously a la valeur True, elle remplace le paramètre de la propriété DeliveryQoS.

DeliveryQoS

Type de données : uint32

Type d’accès : lecture/écriture

Qualité de service pour un abonnement. Si la propriété DeliverSynchronously a la valeur True, elle remplace le paramètre de la propriété DeliveryQoS.

WMIMSG_FLAG_QOS_SYNCHRONOUS (0)

Remise synchrone

Faux. L’événement est remis au consommateur logique de façon synchrone.

WMIMSG_FLAG_QOS_EXPRESS (1)

Remise expresse

Vrai. L’événement est remis au consommateur logique de manière asynchrone.

Filter

Type de données : __EventFilter

Type d’accès : lecture/écriture

Qualificateurs : Clé

Référence à une instance de __EventFilter qui représente le chemin d’accès de l’objet à un filtre d’événements, qui est une requête qui spécifie le type d’événement à recevoir.

MaintainSecurityContext

Type de données : booléen

Type d’accès : lecture/écriture

Si la valeur est True, les événements sont remis dans le même contexte de sécurité que celui dans lequel se trouvait le fournisseur lorsqu’il les a fournis.

Notes

Seul un consommateur implémenté en tant que DLL (consommateur dans le processus) peut recevoir des événements dans le contexte de sécurité du fournisseur. Pour plus d’informations sur les fournisseurs dans le processus et la sécurité, consultez Hébergement et sécurité du fournisseur. Pour plus d’informations et d’exemples, voir remplacer : Réception d’événements en toute sécurité.

SlowDownProviders

Type de données : booléen

Type d’accès : lecture/écriture

Si la valeur est True, les fournisseurs seront ralentis si ce consommateur ne peut pas suivre le rythme.

Notes

La classe __FilterToConsumerBinding est dérivée de __IndicationRelated, qui n’a aucune propriété.

Les consommateurs d’événements permanents utilisent la classe système __FilterToConsumerBinding pour lier des filtres d’événements aux consommateurs finaux. Une fois le filtre et le consommateur liés, WMI peut transférer les événements qui correspondent au filtre au consommateur correspondant.

Exemples

L’exemple PowerShell Créer une inscription d’événement WMI permanent pour superviser des fichiers de la galerie TechNet utilise __FilterToConsumerBinding dans le cadre d’un script complexe pour configurer une inscription d’événement WMI permanent.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Tous les espaces de noms WMI

Voir aussi

__IndicationRelated

Classes système WMI

Monitoring des événements et réponse à ces derniers avec des consommateurs standard

Surveillance des événements

Création d’un filtre d’événements

Sécurisation des événements WMI