DhcpAuditLogSetParams-Funktion (dhcpsapi.h)

Die DhcpAuditLogSetParams-Funktion legt die Parameter für die Überwachungsprotokollgenerierung auf einem DHCP-Server fest.

Syntax

DWORD DhcpAuditLogSetParams(
  [in] LPWSTR ServerIpAddress,
  [in] DWORD  Flags,
  [in] LPWSTR AuditLogDir,
  [in] DWORD  DiskCheckInterval,
  [in] DWORD  MaxLogFilesSize,
  [in] DWORD  MinSpaceOnDisk
);

Parameter

[in] ServerIpAddress

Unicode-Zeichenfolge, die die IP-Adresse oder den Hostnamen des DHCP-Servers angibt.

[in] Flags

Gibt einen Satz von Bitflags zum Filtern des Überwachungsprotokolls an. Derzeit ist dieser Parameter reserviert und sollte auf 0 festgelegt werden.

[in] AuditLogDir

Unicode-Zeichenfolge, die das spezifische Verzeichnis und den Dateinamen enthält, in dem das Überwachungsprotokoll gespeichert wird. Diese Zeichenfolge sollte den absoluten Pfad innerhalb des Dateisystems enthalten. Beispiel: "C:\logs\dhcp\20031020.log".

[in] DiskCheckInterval

Gibt das Datenträgerüberprüfungsintervall für den Versuch an, das Überwachungsprotokoll in die angegebene Datei zu schreiben, als Anzahl der protokollierten DHCP-Serverereignisse, die zwischen Überprüfungen auftreten sollen. Der Standardwert sind 50 DHCP-Serverereignisse zwischen Überprüfungen.

[in] MaxLogFilesSize

Gibt die maximale Größe der Protokolldatei in Bytes an.

[in] MinSpaceOnDisk

Gibt den mindestens erforderlichen Speicherplatz auf dem Datenträger in Bytes für den Überwachungsprotokollspeicher an.

Rückgabewert

Diese Funktion gibt bei einem erfolgreichen Aufruf ERROR_SUCCESS zurück. Andernfalls wird einer der Fehlercodes der DHCP-Serververwaltungs-API zurückgegeben.

Rückgabecode Beschreibung
ERROR_ACCESS_DENIED
Dieser Aufruf wurde von einem Client ausgeführt, der kein Mitglied der Sicherheitsgruppe "DHCP-Administratoren" ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dhcpsapi.h
Bibliothek Dhcpsapi.lib
DLL Dhcpsapi.dll

Weitere Informationen

DhcpAuditLogGetParams