Clase __FilterToConsumerBinding

  • Artículo

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

Consulte también

__IndicationRelated

Clases del sistema de WMI

Supervisión y respuesta a eventos con consumidores estándar

Supervisión de eventos

Creación de un filtro de eventos

Protección de eventos de WMI