配置 HTTP 服务器 API 错误日志记录

HTTP 服务器 API 错误日志记录由位于以下位置的 HTTP\Parameters 项下的三个注册表值控制：

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

注意

配置值的位置和形式可能会在 Windows 操作系统的未来版本中发生变化。

用户必须具有管理员/本地系统特权才能修改注册表值，以及查看或修改包含它们的日志文件和文件夹。

启动 HTTP 服务器 API 驱动程序时，会读取注册表值中的配置信息。 因此，如果更改了设置，则驱动程序必须停止并重启才能读取新值。 可以使用以下控制台命令完成此操作：

net stop http

net start http

日志文件使用以下约定进行命名：

httperr + SequenceNumber + .log

例如：“httperr4.log”。

当日志文件达到 ErrorLogFileTruncateSize 注册表值指定的最大大小时，将循环使用这些日志文件，并且该值不能小于 1 兆字节 (MB)。

如果错误日志的配置无效或者在写入日志文件时发生任何类型的故障，则 HTTP 服务器 API 将使用事件日志记录来通知管理员未进行错误日志记录。

下表介绍了注册表配置值。

注册表值	说明
EnableErrorLogging	一个 DWORD，可设置为 1（表示 True）来启用错误日志记录，或设置为 0（表示 False）来禁用错误日志记录。 默认值是 1秒。
ErrorLogFileTruncateSize	一个指定错误日志文件最大大小（以字节为单位）的 DWORD。 默认值为 1 MB (0x100000)。 注意：指定的值不能小于默认值。
ErrorLoggingDir	一个字符串，此字符串指定 HTTP 服务器 API 将其日志记录文件放在其中的文件夹。 HTTP 服务器 API 会在放置日志文件的指定文件夹下面创建一个名为“HTTPERR”的子文件夹。 该子文件夹和日志文件接收相同的权限设置，这意味着管理员和本地系统帐户具有完全访问权限，而其他用户没有访问权限。 如果未在注册表中指定文件夹，则默认文件夹如下： "%SystemRoot%\System32\LogFiles" 注意：ErrorLoggingDir 字符串值必须是完全限定的路径，但可以包含“%SystemRoot%”。