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