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	Wbemcons.mof
DLL	Wbemcons.dll

另請參閱

標準取用者類別

建立邏輯取用者

隨時接收事件

__EventConsumer