使用pywin32库中的win32evtlog写入Windows事件日志

Question

我有一个简单的python脚本将在Windows服务器上运行，我想将整个脚本中的特定事件记录到Windows事件日志中。有没有人有一个简单而精确的写入事件日志的例子，所以我可以从事件查看器中查看事件。我已经阅读了pywin32库的文档，但我找不到任何明确的例子。我尝试使用以下方法构建事件：

win32evtlogutil.ReportEvent(ApplicationName, EventID, EventCategory,
                EventType, Inserts, Data, SID)

我没有成功，有人可以更深入地解释一下ReportEvent吗？

Answer 1

一个简单的例子：

>>> import sys
>>> import win32evtlogutil
>>> import win32evtlog
>>> import time
>>>
>>> "Python {:s} on {:s}".format(sys.version, sys.platform)
'Python 3.5.4 (v3.5.4:3f56838, Aug  8 2017, 02:17:05) [MSC v.1900 64 bit (AMD64)] on win32'
>>>
>>> DUMMY_EVT_APP_NAME = "Dummy Application"
>>> DUMMY_EVT_ID = 7040  # Got this from another event
>>> DUMMY_EVT_CATEG = 9876
>>> DUMMY_EVT_STRS = ["Dummy event string {:d}".format(item) for item in range(5)]
>>> DUMMY_EVT_DATA = b"Dummy event data"
>>>
>>> "Current time: {:s}".format(time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()))
 'Current time: 2018-07-18 20:03:08'
>>>
>>> win32evtlogutil.ReportEvent(
...     DUMMY_EVT_APP_NAME, DUMMY_EVT_ID, eventCategory=DUMMY_EVT_CATEG,
...     eventType=win32evtlog.EVENTLOG_WARNING_TYPE, strings=DUMMY_EVT_STRS,
...     data=DUMMY_EVT_DATA)
>>>

输出：

您可以看到我从代码输入的值与事件查看器（mmc）窗口（上图）中的事件字段之间的对应关系。

win32evtlogutil.ReportEvent是[GitHub]: mhammond/pywin32 - Python for Windows (pywin32) Extensions的一部分，它是WINAPIs的Python包装器。

您需要知道的所有内容都在[MS.Docs]: ReportEventA function中解释，这是用于完成此任务的WINAPI。请务必仔细阅读（以及它引用的其他一些URL），以便更加熟悉参数，它们的值可能是什么以及其他信息。

确保不要滥用（包括测试），否则最终可能会使用大量垃圾数据污染事件日志。