DhcpServerQueryAttributes-Funktion (dhcpsapi.h)

Die DhcpServerQueryAttributes-Funktion gibt ein Array von Attributen zurück, die auf dem DHCP-Server festgelegt sind.

Syntax

DWORD DhcpServerQueryAttributes(
  [in]  LPWSTR              ServerIpAddr,
  [in]  ULONG               dwReserved,
  [in]  ULONG               dwAttribCount,
  [in]  DHCP_ATTRIB_ID []   pDhcpAttribs,
  [out] LPDHCP_ATTRIB_ARRAY *pDhcpAttribArr
);

Parameter

[in] ServerIpAddr

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

[in] dwReserved

Reserviert. Dieser Wert muss auf 0 (null) festgelegt werden.

[in] dwAttribCount

Gibt die Anzahl der in pDhcpAttribArr aufgeführten Attribute an.

[in] pDhcpAttribs

Gibt ein Array von DHCP_ATTRIB_ID Werten (der Länge dwAttribCount) an, aus der die entsprechenden Attributinformationen abgerufen werden sollen.

[out] pDhcpAttribArr

Zeiger auf eine DHCP_ATTRIB_ARRAY-Struktur , die die Attribute enthält, die direkt den in pDhcpAttribs[] angegebenen Attribut-ID-Werten entsprechen.

Rückgabewert

Diese Funktion gibt bei einem erfolgreichen Aufruf ERROR_SUCCESS zurück. Andernfalls wird einer der Fehlercodes der DHCP-Serververwaltungs-API zurückgegeben.

Hinweise

Ein DHCP-Serverattribute ist ein Wert, der abgefragt werden kann, um unterstützte und verfügbare Features zu ermitteln.

Aufrufer dieser Funktion sollten den Speicher freigeben, auf den von pDhcpAttribs und pDhcpAttribArr nach der Verwendung verwiesen wird.

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

DHCP_ATTRIB_ARRAY

DhcpServerQueryAttribute