DhcpRemoveOptionV5-Funktion (dhcpsapi.h)

Die DhcpRemoveOptionV5-Funktion entfernt die Definition einer bestimmten Option für eine bestimmte Benutzer- und Anbieterklasse auf der Standardoptionsebene auf dem DHCP-Server. Dadurch wird die Funktionalität in DhcpRemoveOption um Unterstützung für bestimmte Klassen- und Anbieternamen erweitert.

Syntax

DWORD DhcpRemoveOptionV5(
  [in] LPWSTR         ServerIpAddress,
  [in] DWORD          Flags,
  [in] DHCP_OPTION_ID OptionID,
  [in] LPWSTR         ClassName,
  [in] LPWSTR         VendorName
);

Parameter

[in] ServerIpAddress

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

[in] Flags

Gibt ein Bitflag an, das angibt, ob die Option herstellerspezifisch ist. Andernfalls sollte dieser Parameter 0 sein.

Wert	Bedeutung
0x00000000	Dieses Flag sollte festgelegt werden, wenn die Option für die Standardanbieterklasse entfernt wird.
DHCP_FLAGS_OPTION_IS_VENDOR 0x00000003	Dieses Flag sollte festgelegt werden, wenn die Option für eine bestimmte Anbieterklasse entfernt wird.

[in] OptionID

DHCP_OPTION_ID Wert, der den Code für die zu entfernende Option angibt.

[in] ClassName

Unicode-Zeichenfolge, die den DHCP-Klassennamen der Option angibt. Dieser Parameter ist optional.

[in] VendorName

Unicode-Zeichenfolge, die den Anbieter der Option angibt. Dieser Parameter ist optional und sollte NULL sein, wenn Flags nicht auf DHCP_FLAGS_OPTION_IS_VENDOR festgelegt ist.

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_OPTION_NOT_PRESENT	Die angegebene Optionsdefinition ist in der DHCP-Serverdatenbank nicht vorhanden.
ERROR_DHCP_CLASS_NOT_FOUND	Der angegebene Klassenname ist entweder unbekannt oder falsch.

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

DhcpCreateOptionV5