Clase __FilterToConsumerBinding
La clase del sistema __FilterToConsumerBinding se usa en el registro de consumidores de eventos permanentes para relacionar una instancia de __EventConsumer con una instancia de __EventFilter. __FilterToConsumerBinding es una clase de asociación.
La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se indican en orden alfabético, no en orden de MOF.
Sintaxis
class __FilterToConsumerBinding : __IndicationRelated
{
__EventConsumer REF Consumer;
uint8 CreatorSID[];
boolean DeliverSynchronously = False;
uint32 DeliveryQoS;
__EventFilter REF Filter;
boolean MaintainSecurityContext = False;
boolean SlowDownProviders = False;
};
Miembros
La clase __FilterToConsumerBinding tiene estos tipos de miembros:
Propiedades
La clase __FilterToConsumerBinding tiene estas propiedades.
-
Consumidor
-
-
Tipo de datos: __EventConsumer
-
Tipo de acceso: lectura/escritura
-
Calificadores: Key
Referencia a una instancia de __EventConsumer que representa la ruta de acceso del objeto a un consumidor lógico, el destinatario de un evento. Un consumidor lógico es una instancia de una clase derivada de __EventConsumer.
-
-
CreatorSID
-
-
Tipo de datos: matriz uint8
-
Tipo de acceso: lectura/escritura
Identificador de seguridad (SID) que identifica de forma única al usuario que ha creado el enlace. En función del sistema operativo, WMI almacena el SID de administrador o el SID del usuario que crea una instancia de __FilterToConsumerBinding. Para más información, consulte Enlace de un filtro de eventos con un consumidor lógico y Supervisión y respuesta a eventos con consumidores estándar.
-
-
DeliverSynchronously
-
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
Obsoleto. En su lugar, use la propiedad DeliveryQoS en lugar de esta propiedad, ya que si DeliverSynchronously se establece en True, invalida el valor de la propiedad DeliveryQoS.
-
-
DeliveryQoS
-
-
Tipo de datos: uint32
-
Tipo de acceso: lectura/escritura
Calidad de servicio para una suscripción. Si la propiedad DeliverSynchronously se establece en True, invalida el valor de la propiedad DeliveryQoS.
-
-
WMIMSG_FLAG_QOS_SYNCHRONOUS (0)
-
Entrega sincrónica
False. El evento se entrega al consumidor lógico de forma sincrónica.
-
WMIMSG_FLAG_QOS_EXPRESS (1)
-
Entrega urgente
True. El evento se entrega al consumidor lógico de forma asincrónica.
Filter
-
Tipo de datos: __EventFilter
-
Tipo de acceso: lectura/escritura
-
Calificadores: Key
Referencia a una instancia de __EventFilter que representa la ruta de acceso del objeto a un filtro de eventos que es una consulta que especifica el tipo de evento que se va a recibir.
MaintainSecurityContext
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
Si es True, los eventos se entregan en el mismo contexto de seguridad en el que estaba el proveedor cuando los proporcionó.
Nota
Solo un consumidor implementado como DLL (un consumidor en proceso) puede recibir eventos en el contexto de seguridad del proveedor. Para más información sobre los proveedores y la seguridad en proceso, consulte Hospedaje y seguridad del proveedor. Para obtener más información y ejemplos, consulte Recibir eventos de forma segura.
SlowDownProviders
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
Si es True, los proveedores se ralentizan si este consumidor no puede mantenerse al día.
Comentarios
La clase __FilterToConsumerBinding se deriva de __IndicationRelated, que no tiene propiedades.
Los consumidores de eventos permanentes usan la clase del sistema __FilterToConsumerBinding para enlazar filtros de eventos a consumidores finales. Una vez enlazados el filtro y el consumidor, WMI puede reenviar eventos que coincidan con el filtro al consumidor correspondiente.
Ejemplos
El ejemplo de PowerShell Creación de un registro de eventos de WMI permanente para supervisar archivos en la Galería de TechNet usa __FilterToConsumerBinding como parte de un script complejo para configurar un registro de eventos de WMI permanente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Todos los espacios de nombres WMI |