DhcpV4RemovePolicyRange, fonction (dhcpsapi.h)

Article
08/23/2023

La fonction DhcpV4RemovePolicyRange supprime la plage d’adresses IP spécifiée de la liste des plages d’adresses IP de la stratégie.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4RemovePolicyRange(
  [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 à supprimer.

[in] PolicyName

Chaîne Unicode terminée par null qui représente le nom de la plage d’adresses IP de stratégie à supprimer.

[in] Range

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

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_INVALID_PARAMETER	Un ou plusieurs des paramètres n’étaient pas valides.
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_BAD	La plage de stratégie spécifiée n’est pas contenue dans la plage d’adresses IP de l’étendue.

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