DhcpSetClientInfoVQ-Funktion (dhcpsapi.h)

Die DhcpSetClientInfoVQ-Funktion legt einen vorhandenen DHCP-Client-Leasedatensatz in der DHCP-Serverdatensatzdatenbank fest oder ändert diese.

Syntax

DWORD DHCP_API_FUNCTION DhcpSetClientInfoVQ(
  [in] DHCP_CONST WCHAR               *ServerIpAddress,
  [in] DHCP_CONST DHCP_CLIENT_INFO_VQ *ClientInfo
);

Parameter

[in] ServerIpAddress

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

[in] ClientInfo

Zeiger auf eine DHCP_CLIENT_INFO_VQ-Struktur , die den DHCP-Client-Leasedatensatz enthält, der der DHCP-Serverdatenbank hinzugefügt oder in dieser geändert werden soll.

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_JET_ERROR	Fehler beim Zugriff auf die Datenbank des DHCPv6-Servers.
ERROR_DHCP_INVALID_PARAMETER	Die angegebenen Clienthardwareadressdaten sind NULL , oder die Länge ist auf Null festgelegt, oder die Subnetzmaske ist falsch.

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