DhcpSetOptionValues-Funktion (dhcpsapi.h)

Die DhcpSetOptionValues-Funktion legt Optionscodes und die zugehörigen Datenwerte für einen bestimmten Bereich fest, der auf dem DHCP-Server definiert ist.

Syntax

DWORD DHCP_API_FUNCTION DhcpSetOptionValues(
  [in] DHCP_CONST WCHAR                   *ServerIpAddress,
  [in] DHCP_CONST DHCP_OPTION_SCOPE_INFO  *ScopeInfo,
  [in] DHCP_CONST DHCP_OPTION_VALUE_ARRAY *OptionValues
);

Parameter

[in] ServerIpAddress

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

[in] ScopeInfo

Zeiger auf eine DHCP_OPTION_SCOPE_INFO Struktur, die Informationen enthält, die die Ebene (Standard, Server, Bereich oder IPv4-Reservierung) beschreiben, auf der dieser Optionswert festgelegt wird.

[in] OptionValues

Zeiger auf eine DHCP_OPTION_VALUE_ARRAY Struktur, die eine Liste von Optionscodes und den entsprechenden Datenwert enthält, der für sie festgelegt wird.

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_OPTION_NOT_PRESENT	Die angegebene Optionsdefinition konnte in der DHCP-Serverdatenbank nicht gefunden werden.
ERROR_DHCP_SUBNET_NOT_PRESENT	Das angegebene IPv4-Subnetz ist auf dem DHCP-Server nicht vorhanden.
ERROR_DHCP_NOT_RESERVED_CLIENT	Der angegebene DHCP-Client ist kein reservierter Client.
ERROR_FILE_NOT_FOUND	Der in ScopeInfo angegebene Multicastbereich wurde auf dem DHCP-Server nicht gefunden.

Hinweise

Wenn diese Funktion zum ersten Mal aufgerufen wird, werden die angegebenen Optionswerte in der DHCP-Serverdatenbank erstellt. Andernfalls werden die Optionswerte für eine oder mehrere Optionen geändert, die der Standardbenutzerklasse und der Anbieterklasse zugeordnet sind. Diese Werte können für die Standard-, Server-, Bereichs- oder IPv4-Reservierungsebene auf dem DHCP-Server festgelegt werden.

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_OPTION_SCOPE_INFO

DHCP_OPTION_VALUE_ARRAY

DhcpSetOptionValue

DhcpSetOptionValuesV5