DhcpCreateClientInfoVQ, fonction (dhcpsapi.h)

La fonction DhcpCreateClientInfoVQ crée l’enregistrement de bail du client DHCP fourni dans la base de données du serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpCreateClientInfoVQ(
  [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 les informations d’enregistrement de bail du client DHCP à définir sur le serveur DHCP. L’appelant doit remplir les champs ClientIPAddress et ClientHardwareAddress de cette structure ; toutes les autres sont facultatives.

Valeur retournée

Cette fonction retourne ERROR_SUCCESS en cas d’appel réussi. Sinon, elle 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 DHCP.
ERROR_DHCP_CLIENT_EXISTS	L’enregistrement client DHCP fourni existe déjà dans la base de données du serveur DHCP.

Remarques

En outre, cette API marque l’adresse IP du client spécifiée comme indisponible (ou distribuée) pour éviter les collisions d’adresses IP.

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

Voir aussi

DhcpSetClientInfoVQ