Classe __FilterToConsumerBinding

  • Artigo

A classe do sistema __FilterToConsumerBinding é usada no registro de consumidores de eventos permanentes para relacionar uma instância de __EventConsumer a uma instância de __EventFilter. __FilterToConsumerBinding é uma classe de associação.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética e não na ordem do MOF.

Sintaxe

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

Membros

A classe __FilterToConsumerBinding tem estes tipos de membros:

Propriedades

A classe __FilterToConsumerBinding tem essas propriedades.

Consumidor

Tipo de dados: __EventConsumer

Tipo de acesso: leitura/gravação

Qualificadores: Chave

Referência a uma instância de __EventConsumer que representa o caminho do objeto para um consumidor lógico, o destinatário de um evento. Um consumidor lógico é uma instância de uma classe derivada de __EventConsumer.

CreatorSID

Tipo de dados: matriz uint8

Tipo de acesso: leitura/gravação

SID (identificador de segurança) que identifica exclusivamente o usuário que cria a associação. Dependendo do sistema operacional, o WMI armazena o SID do Administrador ou do usuário que cria uma instância de __FilterToConsumerBinding. Para obter mais informações, confira Associar um filtro de evento com um consumidor lógico e Monitorar e responder a eventos com consumidores padrão.

DeliverSynchronously

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Obsoleto. Use a propriedade DeliveryQoS no lugar dessa propriedade, pois se DeliverSynchronously estiver definido como True, substituirá a configuração da propriedade DeliveryQoS.

DeliveryQoS

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

Qualidade de serviço de uma assinatura. Se a propriedade DeliverSynchronously estiver definida como True, substituirá a configuração da propriedade DeliveryQoS.

WMIMSG_FLAG_QOS_SYNCHRONOUS (0)

Entrega síncrona

False. O evento é entregue ao consumidor lógico de forma síncrona.

WMIMSG_FLAG_QOS_EXPRESS (1)

Entrega expressa

True. O evento é entregue ao consumidor lógico de forma assíncrona.

Filter

Tipo de dados: __EventFilter

Tipo de acesso: leitura/gravação

Qualificadores: Chave

Referência a uma instância de __EventFilter que representa o caminho do objeto para um filtro de evento que é uma consulta que especifica o tipo de evento a ser recebido.

MaintainSecurityContext

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Se True, os eventos serão entregues no mesmo contexto de segurança em que o provedor estava quando os forneceu.

Observação

Somente um consumidor implementado como uma DLL (um consumidor em processo) pode receber eventos no contexto de segurança do provedor. Para saber mais sobre a segurança e os provedores em processo, confira Hospedagem e segurança de provedores. Para obter mais informações e exemplos, confira substituir:Receber eventos com segurança.

SlowDownProviders

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Se True, os provedores serão desacelerados se esse consumidor não puder acompanhar.

Comentários

A classe __FilterToConsumerBinding é derivada de __IndicationRelated, que não tem propriedades.

Os consumidores de eventos permanentes usam a classe do sistema __FilterToConsumerBinding para associar filtros de evento aos consumidores finais. Depois que o filtro e o consumidor estiverem associados, o WMI poderá encaminhar eventos que correspondam ao filtro para o consumidor correspondente.

Exemplos

O exemplo Criar registro de evento WMI permanente para monitorar arquivos do PowerShell na Galeria do TechNet usa __FilterToConsumerBinding como parte de um script complexo para configurar um registro de evento WMI permanente.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Todos os namespaces do WMI

Confira também

__IndicationRelated

Classes de sistema do WMI

Monitorar e responder a eventos com consumidores padrão

Monitorando eventos

Criar um filtro de evento

Proteger eventos do WMI