DhcpGetOptionValue-Funktion (dhcpsapi.h)

Die DhcpGetOptionValue-Funktion ruft einen DHCP-Optionswert (den Optionscode und die zugeordneten Daten) für einen bestimmten Bereich ab.

Syntax

DWORD DHCP_API_FUNCTION DhcpGetOptionValue(
  [in]  DHCP_CONST WCHAR                  *ServerIpAddress,
  [in]  DHCP_OPTION_ID                    OptionID,
  [in]  DHCP_CONST DHCP_OPTION_SCOPE_INFO *ScopeInfo,
  [out] LPDHCP_OPTION_VALUE               *OptionValue
);

Parameter

[in] ServerIpAddress

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

[in] OptionID

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

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO Struktur, die Informationen zu dem Bereich enthält, in dem der Optionswert festgelegt ist.

[out] OptionValue

DHCP_OPTION_VALUE Struktur, die den zurückgegebenen Optionscode und die zurückgegebenen Daten enthält.

Hinweis  

Der Arbeitsspeicher für diesen Parameter muss mithilfe von DhcpRpcFreeMemory frei sein.

 

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.

Hinweise

Diese Funktion erfordert die Hostbytereihenfolge für alle DHCP_IP_ADDRESS Werte in Parameterstrukturen.

Anforderungen

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

Weitere Informationen

DHCP_OPTION_VALUE