DhcpAddSubnetElement-Funktion (dhcpsapi.h)

Die DhcpAddSubnetElement-Funktion fügt dem Subnetzeintrag in der DHCP-Datenbank ein Element hinzu, das ein Feature oder einen Aspekt des Subnetzes beschreibt.

Syntax

DWORD DHCP_API_FUNCTION DhcpAddSubnetElement(
  [in] DHCP_CONST WCHAR                    *ServerIpAddress,
  [in] DHCP_IP_ADDRESS                     SubnetAddress,
  [in] DHCP_CONST DHCP_SUBNET_ELEMENT_DATA *AddElementInfo
);

Parameter

[in] ServerIpAddress

Zeiger auf eine Unicode-Zeichenfolge, die die IPv4-Adresse des DHCP-Subnetzes enthält.

[in] SubnetAddress

DHCP_IP_ADDRESS Struktur, die die IPv4-Adresse des Subnetzes enthält.

[in] AddElementInfo

Zeiger auf eine DHCP_SUBNET_ELEMENT_DATA-Struktur , die Informationen zum Subnetzelement enthält, das dem in SubnetAddress angegebenen IPv4-Subnetz entspricht.

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_SUBNET_NOT_PRESENT	Das angegebene IPv4-Subnetz ist nicht vorhanden.
ERROR_DHCP_INVALID_RANGE	Der angegebene IPv4-Adressbereich überlappt entweder einen vorhandenen Bereich oder ist ungültig.
ERROR_DHCP_IPRANGE_CONV_ILLEGAL	Die Konvertierung eines Bereichs in einen rein DHCPv4-Bereich oder in einen rein BOOTP-Bereich ist nicht zulässig, wenn DHCPv4- und BOOTP-Clients im zu konvertierenden Bereich vorhanden sind. Löschen Sie entweder die DHCPv4- oder die BOOTP-Clients manuell aus dem Bereich, je nach Art des zu erstellenden Bereichs.
ERROR_DHCP_IPRANGE_EXISTS	Der angegebene IPv4-Adressbereich ist bereits vorhanden.
ERROR_DHCP_MSCOPE_RANGE_TOO_SMALL	Der Multicastbereich muss mindestens 256 IPv4-Adressen zulassen.
ERROR_DHCP_NOT_RESERVED_CLIENT	Der angegebene DHCPv4-Client ist kein IPv4-Reserverdclient.
ERROR_DHCP_RESERVEDIP_EXISTS	Die angegebene IPv4-Adresse oder Hardwareadresse wird von einem anderen DHCPv4-Client verwendet.
ERROR_DHCP_ADDRESS	Die angegebene Adresse ist nicht verfügbar.

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

DhcpAddSubnetElementV4

DhcpAddSubnetElementV5