DhcpGetSuperScopeInfoV4, fonction (dhcpsapi.h)

La fonction DhcpGetSuperScopeInfoV4 retourne des informations sur la superscope d’un serveur DHCP.

Syntaxe

DWORD DhcpGetSuperScopeInfoV4(
  [in]  DHCP_CONST WCHAR         *ServerIpAddress,
  [out] LPDHCP_SUPER_SCOPE_TABLE *SuperScopeTable
);

Paramètres

[in] ServerIpAddress

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

[out] SuperScopeTable

DHCP_SUPER_SCOPE_TABLE structure qui contient les informations retournées pour la superscope du serveur DHCP fourni.

Remarque  

La mémoire de ce paramètre doit être libre à l’aide de DhcpRpcFreeMemory.

 

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 ».

Remarques

Un superscope est l’ensemble de tous les sous-réseaux définis sur un serveur DHCP, et par conséquent, toutes les étendues ainsi que les plages d’adresses IP que chacune sert. Dans l’ensemble, un superscope fournit un ensemble complet de toutes les adresses IP prises en charge par le serveur DHCP. La table superscope fournit les adresses IP associées à chaque sous-réseau. Pour obtenir les plages d’adresses IP servies par chacune d’elles, DhcpGetSubnetInfo doit être appelé sur l’adresse IP fournie dans chaque structure DHCP_SUPER_SCOPE_TABLE_ENTRY de la table.

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_SUPER_SCOPE_TABLE

DhcpGetSubnetInfo

DhcpSetSuperScopeV4