DhcpV4AddPolicyRange, fonction (dhcpsapi.h)

Article
03/02/2024

La fonction DhcpV4AddPolicyRange ajoute une plage d’adresses IP à une stratégie.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4AddPolicyRange(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in]           LPWSTR          PolicyName,
  [in]           LPDHCP_IP_RANGE Range
);

Paramètres

[in, optional] ServerIpAddress

Pointeur vers une chaîne Unicode terminée par null qui représente l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] SubnetAddress

DHCP_IP_ADDRESS structure qui contient l’adresse de sous-réseau IPv4 de la plage d’adresses IP de stratégie à ajouter.

[in] PolicyName

Chaîne Unicode terminée par un caractère Null qui représente le nom de la plage d’adresses IP de stratégie à ajouter.

[in] Range

Pointeur vers une structure de DHCP_IP_RANGE qui contient la plage d’adresses IP de stratégie à ajouter.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants ou un code d’erreur à partir des codes d’erreur de l’API gestion du serveur DHCP.

Valeur	Signification
ERROR_DHCP_SUBNET_NOT_PRESENT	Le sous-réseau IPv4 spécifié n’existe pas.
ERROR_DHCP_POLICY_NOT_FOUND	La stratégie spécifiée n’existe pas.
ERROR_DHCP_POLICY_RANGE_EXISTS	La plage d’adresses IP de stratégie spécifiée chevauche l’une des plages d’adresses IP de stratégie spécifiées.
ERROR_DHCP_POLICY_RANGE_BAD	La plage d’adresses IP de stratégie spécifiée n’est pas contenue dans la plage d’adresses IP de l’étendue ou la plage d’adresses IP de stratégie spécifiée n’est pas valide.

Configuration requise

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