DhcpCreateOptionV5-Funktion (dhcpsapi.h)

Die DhcpCreateOptionV5-Funktion erstellt eine DHCP-Option.

Syntax

DWORD DhcpCreateOptionV5(
  [in]           LPWSTR         ServerIpAddress,
  [in]           DWORD          Flags,
  [in]           DHCP_OPTION_ID OptionId,
  [in, optional] LPWSTR         ClassName,
  [in, optional] LPWSTR         VendorName,
  [in]           LPDHCP_OPTION  OptionInfo
);

Parameter

[in] ServerIpAddress

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

[in] Flags

Flagwert, der angibt, ob die Option für eine bestimmte Oder Standardanbieterklasse gilt.

Wert	Bedeutung
0x00000000	Der Optionswert wird für eine Standardanbieterklasse abgerufen.
DHCP_FLAGS_OPTION_IS_VENDOR 0x00000003	Der Optionswert wird für eine bestimmte Anbieterklasse abgerufen. Der Anbietername wird in VendorName angegeben.

[in] OptionId

DHCP_OPTION_ID Wert, der die eindeutige Options-ID-Nummer (auch als "Optionscode" bezeichnet) der neuen Option enthält. Viele dieser Options-ID-Nummern sind definiert. Eine vollständige Liste der Standardmäßigen DHCP- und BOOTP-Optionscodes finden Sie unter DHCP-Optionen und BOOTP-Anbietererweiterungen.

[in, optional] ClassName

Unicode-Zeichenfolge, die den Namen der DHCP-Klasse angibt, die diese Option enthält. Dieses Feld ist optional.

[in, optional] VendorName

Unicode-Zeichenfolge, die eine Anbieternamenzeichenfolge enthält, wenn die in ClassName angegebene Klasse eine anbieterspezifische Klasse ist.

[in] OptionInfo

DHCP_OPTION Struktur, die Informationen zur Beschreibung der neuen DHCP-Option enthält, einschließlich des Namens, eines optionalen Kommentars und aller zugehörigen Datenelemente.

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

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