Fonction DhcpSetClientInfoVQ (dhcpsapi.h)

La fonction DhcpSetClientInfoVQ définit ou modifie un enregistrement de bail client DHCP existant dans la base de données d’enregistrements du serveur DHCP.

Syntaxe

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

Paramètres

[in] ServerIpAddress

Chaîne Unicode qui spécifie l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] ClientInfo

Pointeur vers une structure de DHCP_CLIENT_INFO_VQ qui contient l’enregistrement de bail du client DHCP à ajouter ou modifier dans la base de données du serveur DHCP.

Valeur retournée

Cette fonction retourne ERROR_SUCCESS en cas d’appel réussi. Sinon, il retourne l’un des codes d’erreur de l’API gestion du serveur DHCP.

Code de retour Description
ERROR_ACCESS_DENIED
Cet appel a été effectué par un client qui n’est pas membre du groupe de sécurité « Administrateurs DHCP ».
ERROR_DHCP_JET_ERROR
Une erreur s’est produite lors de l’accès à la base de données du serveur DHCPv6.
ERROR_DHCP_INVALID_PARAMETER
Les données d’adresse matérielle du client fournies sont NULL ou la longueur est définie sur zéro, ou le masque de sous-réseau est incorrect.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dhcpsapi.h
Bibliothèque Dhcpsapi.lib
DLL Dhcpsapi.dll