DhcpAddSubnetElement, fonction (dhcpsapi.h)

Article
08/23/2023

La fonction DhcpAddSubnetElement 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.

Syntaxe

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

Paramètres

[in] ServerIpAddress

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

[in] SubnetAddress

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

[in] AddElementInfo

Pointeur vers une structure DHCP_SUBNET_ELEMENT_DATA qui contient des informations sur l’élément de sous-réseau correspondant au sous-réseau IPv4 spécifié dans SubnetAddress.

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_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

DhcpAddSubnetElementV4

DhcpAddSubnetElementV5

Share via