DhcpDeleteFilterV4, fonction (dhcpsapi.h)

  • Article

La fonction DhcpDeleteFilterV4 supprime une adresse ou un modèle d’adresse de couche de liens des listes d’autorisation/refus d’un serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpDeleteFilterV4(
  [in] DHCP_CONST WCHAR  *ServerIpAddress,
  [in] DHCP_ADDR_PATTERN *DeleteFilterInfo
);

Paramètres

[in] ServerIpAddress

Pointeur vers une chaîne Unicode qui spécifie l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] DeleteFilterInfo

Pointeur vers une structure DHCP_ADDR_PATTERN qui contient l’adresse de couche liaison ou le filtre de modèle d’adresse à supprimer de la base de données du serveur DHCP.

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_LINKLAYER_ADDRESS_DOES_NOT_EXIST
 L’adresse ou le modèle d’adresse n’existe pas dans une liste d’autorisation/refus.
ERROR_INVALID_PARAMETER
 L’adresse ou le modèle d’adresse fourni dans DeleteFilterInfo 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 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dhcpsapi.h
Bibliothèque Dhcpsapi.lib
DLL Dhcpsapi.dll

Voir aussi

DHCP_ADDR_PATTERN

DhcpAddFilterV4