DhcpCreateOptionV6-Funktion (dhcpsapi.h)

Die DhcpCreateOptionV6-Funktion erstellt eine DHCP-Option.

Syntax

DWORD DHCP_API_FUNCTION DhcpCreateOptionV6(
  [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

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. Andernfalls sollte dieser Parameter 0 sein.

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

[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 http://www.ietf.org/rfc/rfc3315.txt.

[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_INVALID_PARAMETER	Die Parameter waren ungültig.
ERROR_DUPLICATE_TAG	Der angegebene Bereich ist bereits vorhanden.
ERROR_FILE_NOT_FOUND	Der Anbietername ist ungültig. Dies liegt in der Regel daran, dass der Anbietername mehr als 255 Zeichen lang ist.

Anforderungen

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