Fonction DhcpV4CreatePolicy (dhcpsapi.h)

La fonction DhcpV4CreatePolicy crée une stratégie sur le serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4CreatePolicy(
  [in, optional] LPWSTR        ServerIpAddress,
  [in]           LPDHCP_POLICY pPolicy
);

Paramètres

[in, optional] ServerIpAddress

Pointeur vers une chaîne Unicode terminée par null qui représente l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] pPolicy

Pointeur vers une structure DHCP_POLICY qui contient les paramètres de la stratégie à créer.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants.

Valeur Signification
ERROR_DHCP_SUBNET_NOT_PRESENT
Le sous-réseau IPv4 spécifié n’existe pas.
ERROR_DHCP_RANGE_INVALID_IN_SERVER_POLICY
Une plage de stratégies a été spécifiée pour une stratégie au niveau du serveur.
ERROR_DHCP_INVALID_POLICY_EXPRESSION
Les conditions ou expressions spécifiées de la stratégie ne sont pas valides.
ERROR_DHCP_POLICY_RANGE_BAD
La plage d’adresses IP de stratégie spécifiée n’est pas contenue dans la plage d’adresses IP de l’étendue ou la plage d’adresses IP de stratégie spécifiée n’est pas valide.
ERROR_DHCP_POLICY_EXISTS
Le nom de stratégie spécifié existe au niveau spécifié (serveur ou étendue).
ERROR_DHCP_POLICY_RANGE_EXISTS
La plage d’adresses IP de stratégie spécifiée chevauche les plages d’adresses IP de stratégie d’une stratégie existante à l’étendue spécifiée.
ERROR_DHCP_INVALID_PROCESSING_ORDER
L’ordre de traitement spécifié est supérieur à l’ordre de traitement maximal des stratégies existantes au niveau spécifié (serveur ou étendue).
ERROR_DHCP_CLASS_NOT_FOUND
La classe fournisseur ou la référence de classe utilisateur dans les conditions de la stratégie n’existe pas.
ERROR_INVALID_PARAMETER
Les paramètres n’étaient pas valides.

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dhcpsapi.h
Bibliothèque Dhcpsapi.lib
DLL Dhcpsapi.dll

Voir aussi

DhcpV4AddPolicyRange

DhcpV4DeletePolicy

DhcpV4EnumPolicies

DhcpV4GetPolicy

DhcpV4QueryPolicyEnforcement

DhcpV4RemovePolicyRange

DhcpV4SetPolicy

DhcpV4SetPolicyEnforcement