Fonction DhcpSetSuperScopeV4 (dhcpsapi.h)
La fonction DhcpSetSuperScopeV4 définit un sous-réseau comme superscope sur un serveur DHCP.
Syntaxe
DWORD DhcpSetSuperScopeV4(
[in] DHCP_CONST WCHAR *ServerIpAddress,
[in] DHCP_CONST DHCP_IP_ADDRESS SubnetAddress,
[in, optional] DHCP_CONST LPWSTR SuperScopeName,
[in] DHCP_CONST BOOL ChangeExisting
);
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] SubnetAddress
DHCP_IP_ADDRESS valeur qui contient l’adresse IP du sous-réseau qui sera défini comme superscope.
[in, optional] SuperScopeName
Pointeur vers une chaîne Unicode qui spécifie le nouveau nom du superscope.
[in] ChangeExisting
Spécifie s’il faut ou non modifier un superscope existant en sous-réseau fourni. Si ce paramètre a la valeur TRUE et qu’un autre sous-réseau est défini comme superscope, remplacez le superscope par le sous-réseau fourni ; sinon, si la valeur est FALSE et si un autre sous-réseau est défini comme superscope, ne le modifiez pas.
Valeur retournée
Cette fonction retourne ERROR_SUCCESS en cas d’appel réussi. Sinon, il 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
Un superscope est un sous-réseau qui contient l’étendue complète de toutes les adresses disponibles pour le bail (ou déjà louées) sur les étendues de sous-réseau définies sur le serveur DHCP.
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 |