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，則記錄檔是多位元組程式碼文字檔。 如果檔案存在，則會忽略這個屬性，並使用目前的檔案設定。 例如，如果 IsUnicode 為 FALSE，但現有的檔案是 Unicode 檔案，則會使用 Unicode。 如果 IsUnicode 為 TRUE，但檔案是多位元組程式碼，則會使用多位元組程式碼。

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