DhcpSetFilterV4, fonction (dhcpsapi.h)
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 |
---|---|
|
Cet appel a été effectué par un client qui n’est pas membre du groupe de sécurité « Administrateurs DHCP ». |
|
Une erreur s’est produite lors de l’accès à la base de données du serveur DHCP. |
|
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 |