Fonction DhcpSetSuperScopeV4 (dhcpsapi.h)

  • Article

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

Voir aussi

DhcpDeleteSuperScopeV4