DhcpGetAllOptions-Funktion (dhcpsapi.h)

Die DhcpGetAllOptions-Funktion gibt ein Array zurück, das alle auf dem DHCP-Server definierten Optionen enthält.

Syntax

DWORD DhcpGetAllOptions(
  [in]  LPWSTR             ServerIpAddress,
  [in]  DWORD              Flags,
  [out] LPDHCP_ALL_OPTIONS *OptionStruct
);

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 oder nicht. 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.

[out] OptionStruct

Zeiger auf eine DHCP_ALL_OPTIONS-Struktur , die jede für einen Anbieter oder eine Standardklasse definierte Option enthält. Wenn auf dem Server keine Optionen verfügbar sind, ist dieser Wert NULL.

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_DHCP_JET_ERROR	Fehler beim Zugriff auf die DHCP-Serverdatenbank.

Hinweise

Es gibt ein Optionselement im Array, das von OptionStruct für jedes auf dem DHCP-Server definierte Anbieter-/Klassenpaar angegeben wird.

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

DhcpGetAllOptionValues