DhcpAddSubnetElementV4, fonction (dhcpsapi.h)

  • Article

La fonction DhcpAddSubnetElementV4 ajoute un élément décrivant une fonctionnalité ou un aspect du sous-réseau à l’entrée de sous-réseau dans la base de données DHCP. Cette fonction étend DhcpAddSubnetElement en incorporant des éléments de sous-réseau qui prennent en compte le type de client.

Note Cette fonction n’est pas disponible dans Windows antérieur à Windows NT 4.0 Service Pack 1.
 

Syntaxe

DWORD DHCP_API_FUNCTION DhcpAddSubnetElementV4(
  [in] DHCP_CONST WCHAR                       *ServerIpAddress,
  [in] DHCP_IP_ADDRESS                        SubnetAddress,
  [in] DHCP_CONST DHCP_SUBNET_ELEMENT_DATA_V4 *AddElementInfo
);

Paramètres

[in] ServerIpAddress

Pointeur vers une chaîne Unicode qui contient l’adresse IP du serveur DHCP du sous-réseau.

[in] SubnetAddress

DHCP_IP_ADDRESS structure qui contient l’adresse IP du sous-réseau.

[in] AddElementInfo

DHCP_SUBNET_ELEMENT_DATA_V4 structure qui contient les données d’élément à ajouter au sous-réseau. La structure V4 ajoute la prise en charge de la différenciation entre les clients DHCP et BOOTP.

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_DHCP_JET_ERROR
 Une erreur s’est produite lors de l’accès à la base de données du serveur DHCP.
ERROR_DHCP_SUBNET_NOT_PRESENT
 Le sous-réseau IPv4 spécifié n’existe pas.
ERROR_DHCP_OPTION_NOT_PRESENT
 La définition d’option spécifiée n’existe pas dans la base de données du serveur DHCP.
ERROR_DHCP_INVALID_RANGE
 La plage d’adresses IPv4 spécifiée chevauche une plage existante ou n’est pas valide.
ERROR_DHCP_IPRANGE_CONV_ILLEGAL
 La conversion d’une étendue en étendue DHCPv4 uniquement ou en étendue BOOTP uniquement n’est pas autorisée lorsque les clients DHCPv4 et BOOTP sont présents dans l’étendue à convertir. Supprimez manuellement les clients DHCPv4 ou BOOTP de l’étendue, en fonction du type d’étendue en cours de création.
ERROR_DHCP_IPRANGE_EXISTS
 La plage d’adresses IPv4 spécifiée existe déjà.
ERROR_DHCP_MSCOPE_RANGE_TOO_SMALL
 La plage d’étendue de multidiffusion doit autoriser au moins 256 adresses IPv4.
ERROR_DHCP_NOT_RESERVED_CLIENT
 Le client DHCPv4 spécifié n’est pas un reserverdclient IPv4.
ERROR_DHCP_RESERVEDIP_EXISTS
 L’adresse IPv4 ou l’adresse matérielle spécifiée est en cours d’utilisation par un autre client DHCPv4.
ERROR_DHCP_ADDRESS
 L’adresse spécifiée n’est pas disponible.

Spécifications

   
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

DHCP_SUBNET_ELEMENT_DATA_V4

DhcpAddSubnetElement

DhcpAddSubnetElementV5