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