DhcpRemoveOptionValue-Funktion (dhcpsapi.h)

Die DhcpRemoveOptionValue-Funktion entfernt den Optionswert für eine bestimmte Option auf dem DHCP4-Server für die Standardbenutzerklasse und die Anbieterklasse für den angegebenen Bereich.

Syntax

DWORD DHCP_API_FUNCTION DhcpRemoveOptionValue(
  [in] DHCP_CONST WCHAR                  *ServerIpAddress,
  [in] DHCP_OPTION_ID                    OptionID,
  [in] DHCP_CONST DHCP_OPTION_SCOPE_INFO *ScopeInfo
);

Parameter

[in] ServerIpAddress

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

[in] OptionID

DHCP_OPTION_ID Wert, der den Code enthält, der eindeutig die spezifische Option identifiziert, die vom DHCP-Server entfernt werden soll.

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO Struktur, die Informationen enthält, die den spezifischen Bereich (Standard, Server, Bereich oder IPv4-Reservierungsebene) beschreiben, aus dem der Optionswert entfernt werden soll.

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_DHCP_JET_ERROR	Fehler beim Zugriff auf die DHCP-Serverdatenbank.
ERROR_DHCP_OPTION_NOT_PRESENT	Die angegebene Optionsdefinition wurde in der DHCP-Serverdatenbank nicht gefunden.
ERROR_DHCP_SUBNET_NOT_PRESENT	Das angegebene IPv4-Subnetz ist auf dem DHCP-Server nicht definiert.
ERROR_DHCP_NOT_RESERVED_CLIENT	Der angegebene DHCP-Client ist kein reservierter Client.

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_OPTION_SCOPE_INFO

DhcpRemoveOptionValueV5

DhcpSetOptionValue