nteventlog

nteventlog

模块

nteventlog

模块摘要

与Windows事件日志的接口

描述

nteventlog为Windows事件日志提供了一个通用接口。它是OS_Mon应用程序的一部分，请参阅os_mon(6)。适用于事件日志可用的Windows版本。也就是说，不适用于Windows 98和其他一些较旧的Windows版本，但适用于大多数（全部）较新的Windows版本。

此模块用作Windows后端os_sup，见os_sup(3)...

为了保持向后兼容性，该模块还可用于启动nteventlog不属于OS_Mon监督树的独立进程。当启动这样一个过程时，用户必须提供一个标识符以及一个回调函数来处理这些消息。

只要同一个应用程序（或节点）想要启动该进程，就应该重用该标识符（一个任意字符串）。 从当前标识符的上次接受消息开始，将向nteventlog通知所有已到达事件日志的事件。 只要使用相同的标识符，相同的事件日志记录将不会多次发送到nteventlog（除了出现严重系统故障时），在这种情况下，在故障发生之前写入的最后记录可能会在发送给Erlang之后再次发送给Erlang 重启）。

如果事件日志被配置为自动环绕，那么当nteventlog未运行时已到达日志并被覆盖的记录将丢失。 然而，它检测到这种状态并丢失没有被覆盖的记录。

回调函数的工作原理如下os_sup(3)。

输出

start(Identifier, MFA) -> Resultstart_link(Identifier, MFA) -> Result

类型

此函数启动独立的nteventlog进程，如果start_link/2被使用，链接到它。

Identifier如上所述的标识符。

MFA提供的回调函数。何时nteventlog接收到有关新事件的信息，此函数将被调用为apply(Mod, Func, [Event|Args])何地Event是元组

stop() -> stopped

类型

停止nteventlog。通常只在开发过程中使用。服务器不必妥善关闭以保持其状态。

另见

os_mon(6)，os_sup(3)

Windows NT文档