Fonction DhcpCreateSubnetVQ (dhcpsapi.h)

  • Article

La fonction DhcpCreateSubnetVQ crée un sous-réseau IPv4 et ses informations d’état NAP associées sur le serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpCreateSubnetVQ(
  [in] DHCP_CONST WCHAR               *ServerIpAddress,
  [in] DHCP_IP_ADDRESS                SubnetAddress,
  [in] DHCP_CONST DHCP_SUBNET_INFO_VQ *SubnetInfo
);

Paramètres

[in] ServerIpAddress

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

[in] SubnetAddress

Valeur DHCP_IP_ADDRESS qui contient l’adresse IPv4 de la passerelle du sous-réseau.

[in] SubnetInfo

Pointeur vers une structure DHCP_SUBNET_INFO_VQ qui contient des paramètres spécifiques pour le sous-réseau, notamment le masque de sous-réseau et l’adresse IPv4 de la passerelle de sous-réseau.

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. Les codes d’erreur couramment retournés sont les suivants :

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_DHCP_SUBNET_EXISTS
 Les paramètres d’étendue IPv4 spécifiés dans le paramètre SubnetInfo sont incorrects. Soit l’étendue IPv4 existe déjà, soit son adresse de sous-réseau et son masque sont incohérents avec l’adresse de sous-réseau et le masque d’une étendue existante.

Spécifications

   
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_SUBNET_INFO_VQ