__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

访问类型:读/写

限定符:Key

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

CreatorSID

数据类型:uint8 数组

访问类型:读/写

唯一标识创建绑定的用户的安全标识符 (SID)。 WMI 存储管理员 SID 或创建 __FilterToConsumerBinding 实例的用户的 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

访问类型:读/写

限定符:Key

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

MaintainSecurityContext

数据类型:布尔

访问类型:读/写

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

注意

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

SlowDownProviders

数据类型:布尔

访问类型:读/写

若为 True,如果此使用者跟不上,提供程序会减慢速度。

备注

__FilterToConsumerBinding 类派生自 __IndicationRelated,后者没有属性。

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

示例

TechNet 库中的创建用于监视文件的永久 WMI 事件注册 PowerShell 示例在复杂脚本中使用 __FilterToConsumerBinding 来设置永久 WMI 事件注册。

要求

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

另请参阅

__IndicationRelated

WMI 系统类

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

监视事件

创建事件筛选器

保护 WMI 事件