__EventFilter 類別

永久事件取用者的註冊需要__EventFilter 系統類別的 實例。

下列語法是從 Managed 物件格式 （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 實例或管理員istrator SID 之 使用者的 SID。 如需詳細資訊，請參閱 使用邏輯取 用者系結事件篩選， 以及使用標準取用者 監視和回應事件。

EventAccess

資料類型： 字串

存取類型：讀取/寫入

安全性描述元定義語言 （SDDL） 中的安全性描述元 （SDDL） 可控制傳遞至篩選之事件的存取權。 使用這個屬性來指定只有特定帳戶的安全性內容中的事件可以傳遞至此篩選。 例如，永久事件取用者只有在特定使用者產生特定事件時，才能清除安全性記錄。 若要指定誰可以將事件發佈至此篩選，請使用 SECURITY_DESCRIPTOR 屬性之 存取控制 Entry （ACE） 中的WBEM_RIGHT_PUBLISH 遮罩。 如需詳細資訊，請參閱 安全性描述元定義語言 。 如需用來設定此安全性描述元之常數的詳細資訊，請參閱 WMI 安全性常數 。 如需詳細資訊和範例，請參閱 Replace： Receiving Events Securely 。

您可以設定事件存取安全性描述元，只允許在本機系統帳戶產生事件時傳遞事件。 如需建立安全性描述元和授權存取權的詳細資訊，請參閱 存取控制 。

範例：下列 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 。

需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
Namespace	所有 WMI 命名空間

另請參閱

__IndicationRelated

WMI 系統類別

建立事件篩選

隨時接收事件

使用標準取用者監視和回應事件

監視事件

標準取用者類別

保護 WMI 事件