Fonction DhcpV4SetPolicy (dhcpsapi.h)

La fonction DhcpV4SetPolicy met à jour un ou plusieurs paramètres d’une stratégie existante.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4SetPolicy(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           DWORD           FieldsModified,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in]           LPWSTR          PolicyName,
  [in]           LPDHCP_POLICY   Policy
);

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] FieldsModified

Valeur de l’énumération DHCP_POLICY_FIELDS_TO_UPDATE qui définit les champs de stratégie DHCPv4 à modifier.

[in] fGlobalPolicy

Si TRUE, la stratégie au niveau du serveur est définie. Sinon, la stratégie de niveau d’étendue est définie.

[in] SubnetAddress

DHCP_IP_ADDRESS structure qui contient l’adresse de sous-réseau IPv4 de la stratégie à modifier.

[in] PolicyName

Chaîne Unicode terminée par null qui représente le nom de la stratégie à modifier.

[in] Policy

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

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 ou un code d’erreur à partir des codes d’erreur de l’API gestion du serveur DHCP.

Valeur Signification
ERROR_INVALID_PARAMETER
Un ou plusieurs des paramètres n’étaient pas valides.
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 de stratégies spécifiée n’est pas contenue dans la plage d’adresses IP de l’étendue ou la plage de stratégie spécifiée n’est pas valide.
ERROR_DHCP_POLICY_RANGE_EXISTS
La plage de stratégies spécifiée chevauche les plages 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.

Configuration requise

Condition requise Valeur
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

DhcpV4CreatePolicy

DhcpV4DeletePolicy

DhcpV4EnumPolicies

DhcpV4GetPolicy

DhcpV4QueryPolicyEnforcement

DhcpV4RemovePolicyRange

DhcpV4SetPolicyEnforcement