__FilterToConsumerBinding类

__FilterToConsumerBinding系统类用于注册永久事件使用者,将__EventConsumer实例与__EventFilter实例相关联。__FilterToConsumerBinding是关联类。

以下语法从托管对象格式 (MOF) 代码简化而来,包括所有继承属性。 属性按字母顺序列出,而不是按 MOF 顺序列出。

语法

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

成员

__FilterToConsumerBinding类包含以下类型的成员:

属性

__FilterToConsumerBinding类具有这些属性。

使用者

数据类型: __EventConsumer

访问类型:读/写

限定符: 密钥

对表示逻辑使用者(事件接收方)的对象路径 的__EventConsumer 实例的引用。 逻辑使用者是派生自 __EventConsumer的类的实例。

CreatorSID

数据类型: uint8 数组

访问类型:读/写

唯一标识创建绑定的用户的安全标识符 (SID) 。 根据操作系统,WMI 存储创建 __FilterToConsumerBinding实例的用户的管理员 SID 或 SID。 有关详细信息,请参阅使用逻辑使用者和监视和响应标准使用者的事件绑定事件筛选器。

DeliverSynchronously

数据类型: 布尔值

访问类型:读/写

已过时。 而是使用 DeliveryQoS 属性代替此属性,因为如果 DeliverSynchronously 设置为 True ,它将替代 DeliveryQoS 属性的设置。

DeliveryQoS

数据类型: uint32

访问类型:读/写

订阅的服务质量。 如果 DeliverSynchronously 属性设置为 True,它将替代 DeliveryQoS 属性的设置。

WMIMSG_FLAG_QOS_SYNCHRONOUS (0)

同步传递

False。 该事件以同步方式传递到逻辑使用者。

WMIMSG_FLAG_QOS_EXPRESS (1)

快递

True。 该事件以异步方式传递到逻辑使用者。

Filter

数据类型: __EventFilter

访问类型:读/写

限定符: 密钥

__EventFilter 实例的引用,该实例表示事件筛选器的对象路径,该筛选器是指定要接收的事件类型的查询。

MaintainSecurityContext

数据类型: 布尔值

访问类型:读/写

如果 为 True,则事件在提供程序提供事件时所在的同一安全上下文中传递。

注意

只有作为 DLL 实现的使用者 (进程内使用者) 才能在提供程序的安全上下文中接收事件。 有关进程内提供程序和安全性的详细信息,请参阅 提供程序托管和安全性。 有关详细信息和示例,请参阅 replace:Secureing Events Securely

SlowDownProviders

数据类型: 布尔值

访问类型:读/写

如果 为 True,则如果此使用者无法跟上,则提供程序会变慢。

注解

__FilterToConsumerBinding类派生自没有属性的 __IndicationRelated

永久性事件使用者使用 __FilterToConsumerBinding 系统类将事件筛选器绑定到最终使用者。 筛选器和使用者绑定在一起后,WMI 可以将与筛选器匹配的事件转发到相应的使用者。

示例

创建永久 WMI 事件注册以监视 TechNet 库中的文件 PowerShell 示例使用__FilterToConsumerBinding作为复杂脚本的一部分来设置永久 WMI 事件注册。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
所有 WMI 命名空间

另请参阅

__IndicationRelated

WMI 系统类

使用标准使用者监视和响应事件

监视事件

创建事件筛选器

保护 WMI 事件