DhcpAddFilterV4-Funktion (dhcpsapi.h)

Die DhcpAddFilterV4-Funktion fügt den Zulassungs-/Ablehnungslisten eine Linkschichtadresse oder ein Adressmuster hinzu.

Syntax

DWORD DHCP_API_FUNCTION DhcpAddFilterV4(
  [in] DHCP_CONST WCHAR     *ServerIpAddress,
  [in] DHCP_FILTER_ADD_INFO *AddFilterInfo,
  [in] BOOL                 ForceFlag
);

Parameter

[in] ServerIpAddress

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

[in] AddFilterInfo

Zeiger auf eine DHCP_FILTER_ADD_INFO-Struktur , die eine Linkebenenadresse oder ein Adressmuster enthält, das der Zulassungs-/Ablehnungsliste des DHCP-Servers hinzugefügt werden soll.

[in] ForceFlag

Wenn TRUE, wird jeder vorhandene übereinstimmende Filter überschrieben. bei FALSE schlägt der Aufruf mit ERROR_DHCP_LINKLAYER_ADDRESS_EXISTS fehl.

Rückgabewert

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

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Dieser Aufruf wurde von einem Client ausgeführt, der nicht Mitglied der Sicherheitsgruppe "DHCP-Administratoren" ist.
ERROR_DHCP_JET_ERROR	Fehler beim Zugriff auf die Datenbank des DHCP-Servers.
ERROR_DHCP_LINKLAYER_ADDRESS_EXISTS	Das Adress- oder Adressmuster ist bereits in einer Zulassungs-/Ablehnungsliste vorhanden.

Hinweise

Diese API ermöglicht DHCP-Clients, deren Adressen der Zulassungsliste hinzugefügt wurden, das Abrufen von Leases und blockiert diese, die der Ablehnungsliste hinzugefügt wurden. Die entsprechenden Listen müssen mit einem Aufruf von DhcpSetFilterV4 aktiviert werden.

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

DHCP_FILTER_ADD_INFO

DhcpSetFilterV4