DhcpAddFilterV4, fonction (dhcpsapi.h)

  • Article

La fonction DhcpAddFilterV4 ajoute une adresse ou un modèle d’adresse de couche de liens aux listes d’autorisation/refus.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpAddFilterV4(
  [in] DHCP_CONST WCHAR     *ServerIpAddress,
  [in] DHCP_FILTER_ADD_INFO *AddFilterInfo,
  [in] BOOL                 ForceFlag
);

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] AddFilterInfo

Pointeur vers une structure DHCP_FILTER_ADD_INFO qui contient une adresse de couche liaison ou un modèle d’adresse à ajouter à la liste d’autorisation/refus du serveur DHCP.

[in] ForceFlag

Si la valeur est TRUE, tout filtre correspondant existant est remplacé ; si la valeur est FALSE, l’appel échoue avec ERROR_DHCP_LINKLAYER_ADDRESS_EXISTS.

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_EXISTS
 L’adresse ou le modèle d’adresse existe déjà dans une liste d’autorisation/refus.

Remarques

Cette API permet aux clients DHCP dont les adresses ont été ajoutées à la liste verte d’obtenir des baux et bloque ceux ajoutés à la liste de refus. Les listes respectives doivent être activées avec un appel à DhcpSetFilterV4.

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_FILTER_ADD_INFO

DhcpSetFilterV4