DhcpSetFilterV4-Funktion (dhcpsapi.h)

Die DhcpSetFilterV4-Funktion aktiviert oder deaktiviert die Zulassungs- und Ablehnungslisten auf einem DHCP-Server.

Syntax

DWORD DHCP_API_FUNCTION DhcpSetFilterV4(
  [in] DHCP_CONST WCHAR        *ServerIpAddress,
  [in] DHCP_FILTER_GLOBAL_INFO *GlobalFilterInfo
);

Parameter

[in] ServerIpAddress

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

[in] GlobalFilterInfo

Zeiger auf eine DHCP_FILTER_GLOBAL_INFO Struktur, die Informationen enthält, die zum Aktivieren oder Deaktivieren von Zulassungs- und Ablehnungslisten verwendet werden.

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_INVALID_PARAMETER	Einer der Parameter stellt einen ungültigen Wert bereit.

Hinweise

Wenn die Filterung aktiviert ist, lässt der DHCP-Server zu, dass die DHCP-Clients, die Linkebenenadressen in der Liste "Zulassen" zugeordnet sind, mit Leases bereitgestellt werden, und blockiert DHCP-Clients, die Adressen in der Liste "Verweigern" zugeordnet sind.

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_GLOBAL_INFO