DhcpGetAllOptionValues-Funktion (dhcpsapi.h)

Die DhcpGetAllOptionValues-Funktion gibt ein Array zurück, das alle Optionswerte enthält, die für einen bestimmten Bereich auf dem DHCP-Server definiert sind.

Syntax

DWORD DhcpGetAllOptionValues(
  [in]  LPWSTR                   ServerIpAddress,
  [in]  DWORD                    Flags,
  [in]  LPDHCP_OPTION_SCOPE_INFO ScopeInfo,
  [out] LPDHCP_ALL_OPTION_VALUES *Values
);

Parameter

[in] ServerIpAddress

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

[in] Flags

Gibt ein Bitflag an, das angibt, ob die Optionen herstellerspezifisch sind. Wenn die Qualifizierung der Anbieteroptionen nicht erforderlich ist, sollte dieser Parameter 0 sein.

Wert	Bedeutung
DHCP_FLAGS_OPTION_IS_VENDOR	Dieses Flag sollte festgelegt werden, wenn anbieterspezifische Optionen gewünscht werden.

[in] ScopeInfo

Zeiger auf eine DHCP_OPTION_SCOPE_INFO-Struktur , die Informationen zum spezifischen Bereich enthält, dessen Optionswerte zurückgegeben werden. Diese Informationen definieren die Optionswerte, die von der Standard-, Server- oder Bereichsebene oder für eine bestimmte IPv4-Reservierung abgerufen werden.

[out] Values

Zeiger auf eine DHCP_ALL_OPTION_VALUES-Struktur , die die zurückgegebenen Optionswerte für den in ScopeInfo angegebenen Bereich enthält.

Hinweis  

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

 

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_ACCESS_DENIED	Dieser Aufruf wurde von einem Client ausgeführt, der kein Mitglied der Sicherheitsgruppe "DHCP-Administratoren" ist.
ERROR_DHCP_SUBNET_NOT_PRESENT	Dieses angegebene IPv4-Sunet ist auf dem DHCP-Server nicht definiert.
ERROR_DHCP_NOT_RESERVED_CLIENT	Der angegebene DHCP-Client ist kein reservierter Client.

Hinweise

Es gibt einen Optionswert im Array, das durch Werte für jedes Auf dem DHCP-Server definierte Anbieter-/Klassenpaar angegeben ist.

Anforderungen

Anforderung	Wert
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

DhcpGetAllOptions