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