事件記錄函式

備註

  • 事件記錄 API 是專為在 Windows Server 2003、Windows XP 或 Windows 2000 作業系統上執行的應用程式所設計。 在 Windows Vista 中,事件記錄基礎結構已重新設計。 設計為在 Windows Vista 或更新版本作業系統上執行的應用程式現在應該使用 Windows 事件記錄檔。

  • 當你在遠端電腦使用此指令時,可能會因 Windows 11(版本 24H2 或更新版本)與 Windows 11(版本 23H2 或更早版本)之間的不相容而產生錯誤,尤其在查看跨版本日誌時。 類似的相容性問題也可能發生在 Windows Server 2025 或更新版本與 Windows Server 2022 或更早版本之間。

下列函式會與事件記錄搭配使用。

功能 描述
BackupEventLog 將指定的事件記錄檔儲存至備份檔。
ClearEventLog 清除指定的事件記錄檔,並選擇性地將記錄檔的目前復本儲存至備份檔。
CloseEventLog 關閉指定事件記錄檔的讀取句柄。
DeregisterEventSource 關閉指定事件記錄檔的寫入句柄。
GetEventLogInformation 擷取指定事件記錄檔的相關信息。
GetNumberOfEventLogRecords 擷取指定事件記錄檔中的記錄數目。
GetOldestEventLogRecord 擷取指定事件記錄檔中最舊記錄的絕對記錄編號。
NotifyChangeEventLog 可讓應用程式在事件寫入指定的事件記錄檔時接收通知。
OpenBackupEventLog 開啟備份事件記錄檔的句柄。
OpenEventLog 開啟指定事件記錄檔的句柄。
ReadEventLog 從指定的事件記錄檔讀取整個專案。
RegisterEventSource 擷取指定事件記錄檔的已註冊句柄。
ReportEvent 在指定的事件記錄檔結尾寫入專案。