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 |
---|---|
|
Un ou plusieurs des paramètres n’étaient pas valides. |
|
Le sous-réseau IPv4 spécifié n’existe pas. |
|
Une plage de stratégies a été spécifiée pour une stratégie au niveau du serveur. |
|
Les conditions ou expressions spécifiées de la stratégie ne sont pas valides. |
|
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. |
|
La plage de stratégies spécifiée chevauche les plages de stratégie d’une stratégie existante à l’étendue spécifiée. |
|
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). |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez :Envoyer et afficher des commentaires pour