Konfigurieren der Fehlerprotokollierung für die HTTP-Server-API

Die Fehlerprotokollierung der HTTP-Server-API wird durch drei Registrierungswerte unter einem \ HTTP-Parameterschlüssel gesteuert, der sich unter befindet:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

Hinweis

Der Speicherort und die Form der Konfigurationswerte können sich in zukünftigen Versionen des Windows ändern.

Ein Benutzer muss über Administrator-/lokale Systemberechtigungen verfügen, um die Registrierungswerte zu ändern und die Protokolldateien und den Ordner, in dem sie enthalten sind, anzeigen oder ändern zu können.

Konfigurationsinformationen in den Registrierungswerten werden gelesen, wenn der HTTP Server-API-Treiber gestartet wird. Wenn die Einstellungen geändert werden, muss der Treiber daher beendet und neu gestartet werden, um die neuen Werte zu lesen. Dies kann mithilfe der folgenden Konsolenbefehle erreicht werden:

net stop http

net start http

Die Protokolldateien werden mithilfe der folgenden Konvention benannt:

httperr + SequenceNumber + .log

Beispiel: "httperr4.log".

Protokolldateien werden zyklengeraden, wenn sie die maximale Größe erreichen, die durch den ErrorLogFileTruncateSize-Registrierungswert angegeben wird, und der Wert darf nicht kleiner als ein Megabyte (MB) sein.

Wenn die Konfiguration der Fehlerprotokollierung ungültig ist oder beim Schreiben in die Protokolldateien ein Fehler auftritt, verwendet die HTTP-Server-API die Ereignisprotokollierung, um Administratoren zu benachrichtigen, dass die Fehlerprotokollierung nicht erfolgt ist.

Die Werte der Registrierungskonfiguration werden in der folgenden Tabelle beschrieben.

Registrierungswert BESCHREIBUNG
EnableErrorLogging
Ein DWORD, das auf TRUE festgelegt werden kann, um die Fehlerprotokollierung zu aktivieren, oder FALSE, um es zu deaktivieren. Der Standardwert ist TRUE.
ErrorLogFileTruncateSize
Ein DWORD, das die maximale Größe einer Fehlerprotokolldatei in Bytes angibt. Der Standardwert ist 1 MB (0x100000).
[!Note]
Der angegebene Wert darf nicht kleiner als der Standardwert sein.

ErrorLoggingDir
Eine Zeichenfolge, die den Ordner angibt, in dem die HTTP-Server-API ihre Protokollierungsdateien platziert.
Die HTTP-Server-API erstellt unter dem angegebenen Ordner, in dem sich die Protokolldateien befinden, einen Unterordner namens "HTTPERR". Dieser Unterordner und die Protokolldateien erhalten die gleichen Berechtigungseinstellungen, was bedeutet, dass Administrator- und lokale Systemkonten Vollzugriff haben, während andere Benutzer keinen Zugriff haben.
Wenn in der Registrierung kein Ordner angegeben ist, ist der Standardordner der folgende:
"%SystemRoot%\System32\LogFiles"
[!Note]
Der ErrorLoggingDir-Zeichenfolgenwert muss ein vollqualifizierter Pfad sein, kann aber "%SystemRoot%" enthalten.