__EventFilter 类

要注册永久事件使用者,需要 __EventFilter 系统类实例。

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

语法

class __EventFilter : __IndicationRelated
{
  uint8  CreatorSID[] = {1,1,0,0,0,0,0,5,18,0,0,0};
  string EventAccess;
  string EventNamespace;
  string Name;
  string Query;
  string QueryLanguage;
};

成员

__EventFilter 类具有以下类型的成员:

属性

__EventFilter 类具有以下属性。

CreatorSID

数据类型:uint8 数组

访问类型:读/写

唯一标识创建此筛选器的用户的安全标识符 (SID)。 Windows Management Instrumentation (WMI) 存储创建 __EventFilter 实例的用户 SID 或管理员 SID,具体取决于操作系统。 有关详细信息,请参阅将事件筛选器与逻辑使用者绑定使用标准使用者监视和响应事件

EventAccess

数据类型:字符串

访问类型:读/写

安全描述符定义语言 (SDDL) 中的安全描述符 (SD),用于控制对传递到筛选器的事件的访问。 使用此属性可指定只有特定帐户的安全上下文中的事件才能传递到此筛选器。 例如,仅当特定事件由特定用户生成时,永久事件使用者才能清除安全日志。 要指定可将事件发布到此筛选器的人员,请使用 SECURITY_DESCRIPTOR 属性的访问控制项 (ACE) 中的 WBEM_RIGHT_PUBLISH 掩码。 有关详细信息,请参阅安全描述符定义语言。 有关用于设置此安全描述符的常量的详细信息,请参阅 WMI 安全常量。 有关详细信息和示例,请参阅安全接收事件

可将事件访问安全描述符配置为仅当本地系统帐户生成事件时才允许传递该事件。 有关创建安全描述符和授予访问权限的详细信息,请参阅访问控制

示例:以下 SDDL 字符串只允许管理员向筛选器提供事件。 提供事件所需的权限是 WBEM_RIGHT_PUBLISH (x80)。

O:BAG:BAD:(A;;0x80;;;BA)

EventNamespace

数据类型:字符串

访问类型:读/写

用于跨命名空间订阅的事件实例的命名空间。

名称

数据类型:字符串

访问类型:读/写

限定符:

事件筛选器的唯一标识符。 由于事件筛选器仅由 WMI 在内部使用,建议将此属性设置为全局唯一标识符 (GUID)(转换为字符串)。 不过,只要不与其他筛选器冲突,使用者可对筛选器名称使用任何专用方案。

查询

数据类型:字符串

访问类型:读/写

Windows Management Instrumentation 查询语言 (WQL) 事件查询,用于指定使用者通知的事件集以及通知的特定条件。

QueryLanguage

数据类型:字符串

访问类型:读/写

用于查询的语言。 由于 WMI 目前只支持 WMI 查询语言 (WQL) 作为查询语言,此属性必须设置为“WQL”。

备注

__EventFilter 类派生自 __IndicationRelated

示例

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

要求

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

另请参阅

__IndicationRelated

WMI 系统类

创建事件筛选器

随时接收事件

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

监视事件

标准使用者类

保护 WMI 事件