DhcpRemoveOptionValueV6-Funktion (dhcpsapi.h)

Die DhcpRemoveOptionValueV6-Funktion entfernt einen Optionswert aus einem auf dem DHCP-Server definierten Bereich.

Syntax

DWORD DHCP_API_FUNCTION DhcpRemoveOptionValueV6(
  [in] LPWSTR                    ServerIpAddress,
  [in] DWORD                     Flags,
  [in] DHCP_OPTION_ID            OptionID,
  [in] LPWSTR                    ClassName,
  [in] LPWSTR                    VendorName,
  [in] LPDHCP_OPTION_SCOPE_INFO6 ScopeInfo
);

Parameter

[in] ServerIpAddress

Zeiger auf eine 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 oder nicht. Wenn dies nicht der Fall ist, sollte dieser Parameter 0 (null) sein.

Wert Bedeutung
DHCP_FLAGS_OPTION_IS_VENDOR
Dieses Flag sollte festgelegt werden, wenn die Option von einem Anbieter bereitgestellt wird.

[in] OptionID

DHCP_OPTION_ID Wert, der den Code für den zu entfernenden Optionswert angibt.

[in] ClassName

Unicode-Zeichenfolge, die den DHCP-Klassennamen des Optionswerts 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.

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO6 Struktur, die Informationen enthält, die den spezifischen Bereich 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_INVALID_PARAMETER
Die Parameter waren ungültig.
ERROR_DHCP_OPTION_NOT_PRESENT
Die angegebene Option ist auf dem DHCP-Server nicht vorhanden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dhcpsapi.h
Bibliothek Dhcpsapi.lib
DLL Dhcpsapi.dll