DhcpScanDatabase, fonction (dhcpsapi.h)

Article
08/23/2023

La fonction DhcpScanDatabase énumère les adresses IPv4 du client DHCPv4 louées qui ne sont pas synchronisées entre le cache en mémoire et la base de données serveur.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpScanDatabase(
  [in]  DHCP_CONST WCHAR *ServerIpAddress,
  [in]  DHCP_IP_ADDRESS  SubnetAddress,
  [in]  DWORD            FixFlag,
  [out] LPDHCP_SCAN_LIST *ScanList
);

Paramètres

[in] ServerIpAddress

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

[in] SubnetAddress

DHCP_IP_ADDRESS valeur qui spécifie le sous-réseau dont les baux seront analysés à la recherche d’adresses IP de bail client désynchronisées.

[in] FixFlag

Spécifie un ensemble d’indicateurs de bits qui indiquent si le cache en mémoire ou la base de données de bail client doivent être la source définitive des correctifs lors de la synchronisation des deux sur le serveur DHCPv4. Ces indicateurs sont énumérés dans DHCP_SCAN_FLAG.

[out] ScanList

DHCP_SCAN_LIST structure qui contient la liste retournée d’adresses IP clientes louées qui ne sont pas synchronisées.

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 DHCPv4.
ERROR_DHCP_SUBNET_NOT_PRESENT	Le sous-réseau spécifié n’est pas défini sur le serveur DHCPv4.

Notes

Chaque adresse IPv4 du client DHCPv4 louée définie sur un serveur DHCPv4 a une entrée à la fois dans un magasin en mémoire, qui sert de cache pour accélérer la récupération des baux, et dans la base de données de bail client proprement dite. DhcpScanDatabase énumère les adresses IPv4 du client DHCPv4 qui sont présentes dans le magasin en mémoire et ne sont pas présentes dans la base de données, ou celles qui sont présentes dans la base de données, mais pas présentes dans le magasin en mémoire.

Ce processus est nécessaire, car le serveur DHCPv4 conserve un cache en mémoire des baux clients fréquemment utilisés pour améliorer les performances, mais il peut être désynchronisé par rapport à la base de données de bail client persistante du serveur. Par conséquent, il est nécessaire de rapprocher les deux magasins et de mettre à jour soit la version en mémoire d’une adresse IP de bail client, soit l’adresse IP du bail du client stockée dans la base de données. La structure DHCP_SCAN_LIST retournée par cette opération contient les baux clients « définitifs » tels que spécifiés par l’emplacement défini par défaut dans le paramètre FixFlag .

Spécifications


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008, 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_SCAN_LIST