DhcpRemoveSubnetElement-Funktion (dhcpsapi.h)

Die DhcpRemoveSubnetElement-Funktion entfernt ein IPv4-Subnetzelement aus einem auf dem DHCPv4-Server definierten IPv4-Subnetz.

Syntax

DWORD DHCP_API_FUNCTION DhcpRemoveSubnetElement(
  [in] DHCP_CONST WCHAR                    *ServerIpAddress,
  [in] DHCP_IP_ADDRESS                     SubnetAddress,
  [in] DHCP_CONST DHCP_SUBNET_ELEMENT_DATA *RemoveElementInfo,
  [in] DHCP_FORCE_FLAG                     ForceFlag
);

Parameter

[in] ServerIpAddress

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

[in] SubnetAddress

DHCP_IP_ADDRESS Wert, der die IPv4-Adresse des Subnetzgateways angibt, aus dem Elemente entfernt werden sollen.

[in] RemoveElementInfo

DHCP_SUBNET_ELEMENT_DATA Struktur, die Informationen enthält, die zum Suchen des Elements verwendet werden, das aus dem in SubnetAddress angegebenen Subnetz entfernt wird.

[in] ForceFlag

DHCP_FORCE_FLAG Enumerationswert, der angibt, ob die vom Entfernen des Subnetzelements betroffenen Clients ebenfalls gelöscht werden sollen.

Hinweis Wenn das Flag auf DhcpNoForce festgelegt ist und dieses Subnetz eine IPv4-Adresse für DHCPv4/BOOTP-Clients bereitgestellt hat, wird der IPv4-Bereich nicht gelöscht. Wenn das Flag hingegen auf DhcpFullForce festgelegt ist, wird der IPv4-Bereich zusammen mit dem DHCPv4-Clientleasingdatensatz auf dem DHCPv4-Server gelöscht.

 

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_DHCP_JET_ERROR	Beim Zugriff auf die DHCP-Serverdatenbank ist ein Fehler aufgetreten.
ERROR_DHCP_SUBNET_NOT_PRESENT	Das angegebene IPv4-Subnetz ist auf dem DHCP-Server nicht definiert.
ERROR_DHCP_RESERVED_CLIENT	Der angegebene DHCP-Client ist ein reservierter Client.
ERROR_DHCP_INVALID_RANGE	Der angegebene IPv4-Adressbereich überlappt entweder einen vorhandenen IPv4-Adressbereich oder ist ungültig.
ERROR_DHCP_ELEMENT_CANT_REMOVE	Mindestens eine Multicast-IPv4-Adresse wurde an einen MADCAP-Client vermietet.

Anforderungen

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_FORCE_FLAG

DHCP_SUBNET_ELEMENT_DATA

DhcpAddSubnetElement