NTEventLogEventConsumer 類別
NTEventLogEventConsumer類別會在將事件傳遞至作業系統事件記錄檔時,將特定訊息記錄至作業系統事件記錄檔。 這個類別是 WMI 所提供的其中一個標準事件取用者。 如需詳細資訊,請參閱 使用標準取用者監視和回應事件。
語法
[AMENDMENT]
class NTEventLogEventConsumer : __EventConsumer
{
uint8 CreatorSID[];
string MachineName;
uint32 MaximumQueueSize;
uint16 Category;
string NameOfRawDataProperty;
uint32 EventID;
uint32 EventType = 1;
string InsertionStringTemplates[] = {""};
string Name;
uint32 NumberOfInsertionStrings = 0;
string NameOfUserSidProperty;
string SourceName;
string UNCServerName;
};
成員
NTEventLogEventConsumer類別具有下列類型的成員:
屬性
NTEventLogEventConsumer類別具有這些屬性。
-
類別
-
-
資料類型: uint16
-
存取類型:唯讀
事件類別目錄。 這是來源特定的資訊,而且可以有任何值。
-
-
CreatorSID
-
-
資料類型: uint8 陣列
-
存取類型:唯讀
安全性識別碼 (SID) ,可唯一識別建立篩選的使用者。 WMI 會根據作業系統儲存建立 __EventConsumer 實例或系統管理員 SID 之使用者的 SID。 如需詳細資訊,請參閱 使用邏輯取用者系結事件篩選 和 監視和使用標準取用者回應事件。
此屬性繼承自 __EventConsumer。
-
-
EventID
-
-
資料類型: uint32
-
存取類型:唯讀
訊息 DLL 中的事件訊息。 此屬性不可為 Null。
-
-
EventType
-
-
資料類型: uint32
-
存取類型:唯讀
事件類別。 此參數可以有下列清單中所列的其中一個值,這些值定義于 Winnt.h 中。
-
-
EVENTLOG_SUCCESS (0 (0x0) )
-
成功事件
-
EVENTLOG_ERROR_TPYE (1 (0x1) )
-
錯誤事件
-
EVENTLOG_WARNING_TYPE (2 (0x2) )
-
警告事件
-
EVENTLOG_INFORMATION_TYPE (4 (0x4) )
-
資訊事件
-
EVENTLOG_AUDIT_SUCCESS (8 (0x8) )
-
成功稽核類型
-
EVENTLOG_AUDIT_FAILURE (16 (0x10) )
-
失敗稽核類型
InsertionStringTemplates
-
資料類型: 字串 陣列
-
存取類型:唯讀
作為事件記錄檔記錄之插入字串的標準字串範本陣列。
MachineName
-
資料類型: 字串
-
存取類型:唯讀
Windows Management Instrumentation (WMI) 傳送事件的電腦名稱稱。
此屬性繼承自 __EventConsumer。
MaximumQueueSize
-
資料類型: uint32
-
存取類型:唯讀
特定取用者的最大佇列,以位元組為單位。
此屬性繼承自 __EventConsumer。
名稱
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: 金鑰
取用者的唯一名稱。
NameOfRawDataProperty
-
資料類型: 字串
-
存取類型:唯讀
包含要傳遞至 ReportEvent 函式 lpRawData 參數之資料的事件屬性名稱。
NameOfUserSidProperty
-
資料類型: 字串
-
存取類型:唯讀
事件屬性的名稱,其中包含要傳遞至 ReportEvent 函式 lpUserSid 參數的安全性識別碼 (SID) 。 屬性必須是位元組陣列, (uint8) 或字串。 如果是位元組陣列,則會假設它是 SID。 如果是字串,它是轉換成 SID 的字串 SID。
NumberOfInsertionStrings
-
資料類型: uint32
-
存取類型:唯讀
InsertionStringTemplates陣列中的元素數目。
SourceName
-
資料類型: 字串
-
存取類型:唯讀
訊息所在的來源名稱。 客戶假設已向必要的訊息註冊 DLL。
注意
此參數的值不得包含冒號 (:) 字元。
UNCServerName
-
資料類型: 字串
-
存取類型:唯讀
要記錄事件的電腦名稱稱,如果事件要記錄在本機伺服器上,則為 Null 。
根據預設,已驗證的使用者無法將事件記錄到遠端電腦上的應用程式記錄檔。 因此,使用這個屬性來指定遠端電腦將無法運作。 若要瞭解如何變更事件記錄檔安全性,請參閱此 知識庫文章。
備註
NTEventLogEventConsumer類別衍生自抽象類別__EventConsumer。
範例
如需使用 NTEventLogEventConsumer 建立取用者的範例,請參閱 根據事件記錄至 NT 事件記錄檔。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
命名空間 |
Root\subscription |
MOF |
|
DLL |
|