DhcpSetFilterV4, fonction (dhcpsapi.h)

  • Article

La fonction DhcpSetFilterV4 active ou désactive les listes d’autorisation et de refus sur un serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpSetFilterV4(
  [in] DHCP_CONST WCHAR        *ServerIpAddress,
  [in] DHCP_FILTER_GLOBAL_INFO *GlobalFilterInfo
);

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

Pointeur vers une structure de DHCP_FILTER_GLOBAL_INFO qui contient les informations utilisées pour activer ou désactiver les listes d’autorisation et de refus.

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_INVALID_PARAMETER
 L’un des paramètres fournit une valeur non valide.

Remarques

Lorsque le filtrage est activé, le serveur DHCP autorise les clients DHCP associés aux adresses de couche de liens dans la liste « autoriser » à être fournis avec des baux et bloque les clients DHCP associés aux adresses dans la liste « refuser ».

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_GLOBAL_INFO