DhcpGetClientInfo-Funktion (dhcpsapi.h)

Die DhcpGetClientInfo-Funktion gibt Informationen zu einem bestimmten DHCP-Client zurück.

Syntax

DWORD DHCP_API_FUNCTION DhcpGetClientInfo(
  [in]  DHCP_CONST WCHAR            *ServerIpAddress,
  [in]  DHCP_CONST DHCP_SEARCH_INFO *SearchInfo,
  [out] LPDHCP_CLIENT_INFO          *ClientInfo
);

Parameter

[in] ServerIpAddress

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

[in] SearchInfo

DHCP_SEARCH_INFO Struktur, die die Parameter für die Suche enthält.

[out] ClientInfo

Zeiger auf eine DHCP_CLIENT_INFO-Struktur , die Informationen enthält, die den DHCP-Client beschreiben, der den bereitgestellten Suchparametern am ehesten entspricht. Wenn kein Client gefunden wird, ist dieser Parameter NULL.

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

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_CLIENT_INFO

DHCP_SEARCH_INFO

DhcpSetClientInfo