共用方式為


LogFileEventConsumer 類別

LogFileEventConsumer類別會在事件傳遞至文字檔時,將自訂字串寫入至文字檔。 字串會以行尾序列分隔。 這個類別是 WMI 提供的其中一個標準事件取用者。 如需詳細資訊,請參閱 使用標準取用者監視和回應事件

語法

[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
  uint8   CreatorSID[];
  string  MachineName;
  uint32  MaximumQueueSize;
  string  Filename;
  boolean IsUnicode;
  uint64  MaximumFileSize = 65535;
  string  Name;
  string  Text;
};

成員

LogFileEventConsumer類別具有下列類型的成員:

屬性

LogFileEventConsumer類別具有這些屬性。

CreatorSID

資料類型: uint8 陣列

存取類型:唯讀

安全識別碼 (SID) ,可唯一識別建立篩選的使用者。 WMI 會根據作業系統儲存建立 __EventConsumer 實例或系統管理員 SID 之使用者的 SID。 如需詳細資訊,請參閱 使用邏輯取用者系結事件篩選監視和使用標準取用者回應事件

此屬性繼承自 __EventConsumer

檔案名稱

資料類型: 字串

存取類型:唯讀

包含記錄專案附加路徑的檔案名。 如果檔案不存在, LogFileEventConsumer 會嘗試建立檔案。 當路徑不存在,或建立取用者的使用者沒有檔案或路徑的寫入權限時,取用者就會失敗。

IsUnicode

資料類型: 布林值

存取類型:唯讀

如果為 TRUE,則記錄檔為 Unicode 文字檔。 如果為 FALSE,則記錄檔是多位元組程式碼文字檔。 如果檔案存在,則會忽略這個屬性,並使用目前的檔案設定。 例如,如果 IsUnicodeFALSE,但現有的檔案是 Unicode 檔案,則會使用 Unicode。 如果 IsUnicodeTRUE,但檔案是多位元組程式碼,則會使用多位元組程式碼。

MachineName

資料類型: 字串

存取類型:唯讀

Windows Management Instrumentation (WMI) 傳送事件的電腦名稱稱。

此屬性繼承自 __EventConsumer

MaximumFileSize

資料類型: uint64

存取類型:唯讀

以位元組為單位的記錄檔大小上限。 如果主要檔案超過其大小上限,則會將內容移至不同的檔案,並清空主要檔案。 值為 0 (零) 表示沒有大小限制。 預設值為 65,535 個位元組。 寫入作業之前會檢查檔案的大小。 因此,您可以有稍微大於指定大小限制的檔案。 下一個寫入作業會攔截它,並啟動新的檔案。

下列清單會識別備份檔案的命名結構:

  • 如果原始檔案名是 8.3,副檔名會以格式為 「001」、「002」 的字串取代,以大於先前使用和所選數位的最小數位取代。 如果使用 「999」,則選擇的數位是最小的未使用數位。
  • 如果原始檔案名不是 8.3,格式為 「001」、「002」 的字串會附加至檔案名。

如需在腳本中使用 uint64 值的詳細資訊,請參閱 WMI 中的腳本

MaximumQueueSize

資料類型: uint32

存取類型:唯讀

特定取用者的最大佇列,以位元組為單位。

此屬性繼承自 __EventConsumer

名稱

資料類型: 字串

存取類型:唯讀

限定詞: 索引鍵

此取用者的唯一名稱。

Text

資料類型: 字串

存取類型:唯讀

記錄專案文字的標準字串 範本

備註

注意

LogFileEventConsumer不會保護記錄檔。 因此,當您設定 LogFileEventConsumer時,請務必指定受到所需層級保護的目錄。

LogFileEventConsumer類別衍生自__EventConsumer抽象類別。

範例

如需使用 LogFileEventConsumer 建立取用者的範例,請參閱 根據事件寫入記錄檔

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
命名空間
Root\subscription
MOF
Wbemcons.mof
DLL
Wbemcons.dll

另請參閱

標準取用者類別

根據事件寫入記錄檔

建立邏輯取用者

隨時接收事件

__EventConsumer