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 |
|
| DLL |
|