共用方式為


事件記錄作業

OpenEventLogOpenBackupEventLogRegisterEventSourceDeregisterEventSourceCloseEventLog函式會開啟和關閉事件記錄檔控制碼。

下表顯示可在開啟的事件記錄檔上執行的作業,以及每個作業的對應函式。

作業 函式
備份 BackupEventLog
清除 ClearEventLog
監視器 NotifyChangeEventLog
查詢 GetOldestEventLogRecordGetNumberOfEventLogRecords
讀取 ReadEventLog
Write ReportEvent

 

OpenEventLogReportEvent函式會採用選擇性伺服器名稱做為參數,以便在遠端伺服器上執行作業。 使用 OpenEventLog 讀取或執行 (備份、清除、監視和查詢記錄檔) 的系統管理作業,並使用 RegisterEventSource 寫入記錄檔。

對事件記錄函式的每個呼叫都是不可部分完成的作業。 當您從事件記錄檔讀取時,只會傳回整個事件記錄。 當您寫入事件記錄檔時,每個事件記錄保證會循序寫入為記錄檔中的完整記錄。 下列清單描述事件記錄服務如何處理特殊條件:

  • 事件記錄服務會同時接收讀取作業和寫入作業:如果讀取位置位於檔案結尾,讀取作業會失敗並出現「檔案結尾」狀態, (如果寫入作業尚未完成) ,則傳回新記錄 (如果寫入作業已完成) 。
  • 事件記錄服務會在收到讀取作業之前完成清除作業:讀取作業失敗並出現「檔案結尾」狀態。
  • 事件記錄服務會在收到寫入作業之前完成清除作業:清除作業會截斷記錄,然後寫入作業會在記錄的開頭新增記錄。