DhcpV4SetOptionValue, fonction (dhcpsapi.h)
La fonction DhcpV4SetOptionValue définit des informations pour une valeur d’option spécifique sur le serveur DHCP. Cette fonction étend la fonctionnalité fournie par DhcpSetOptionValueV5 en autorisant l’appelant à spécifier une stratégie pour l’option.
Syntaxe
DWORD DHCP_API_FUNCTION DhcpV4SetOptionValue(
[in, optional] LPWSTR ServerIpAddress,
[in] DWORD Flags,
[in] DHCP_OPTION_ID OptionId,
[in, optional] LPWSTR PolicyName,
[in, optional] LPWSTR VendorName,
[in] LPDHCP_OPTION_SCOPE_INFO ScopeInfo,
[in] LPDHCP_OPTION_DATA OptionValue
);
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] Flags
Indique si l’option est destinée à un fournisseur spécifique ou par défaut.
[in] OptionId
DHCP_OPTION_ID structure qui spécifie le code d’option unique pour la valeur d’option à récupérer. Vous trouverez la liste complète des codes d’option DHCP et BOOTP standard à l’adresse http://www.ietf.org/rfc/rfc2132.txt
[in, optional] PolicyName
Chaîne Unicode terminée par null qui représente le nom de la stratégie à l’intérieur du sous-réseau de la valeur d’option à définir. Le sous-réseau est identifié par le membre SubnetScopeInfo de ScopeInfo.
[in, optional] VendorName
Chaîne Unicode terminée par null qui représente le fournisseur de l’option. Ce paramètre est facultatif et doit avoir la valeur NULL lorsque les indicateurs ne sont pas DHCP_FLAGS_OPTION_IS_VENDOR. Si le fournisseur n’est pas spécifié, la valeur de l’option est définie pour le fournisseur par défaut.
[in] ScopeInfo
Pointeur vers une structure DHCP_OPTION_SCOPE_INFO qui contient des informations sur l’étendue de la valeur d’option à définir.
[in] OptionValue
Pointeur vers une structure DHCP_OPTION_DATA qui contient la valeur de données correspondant au code d’option DHCP spécifié par OptionID.
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. |
|
Le nom de la classe utilisée est inconnu ou incorrect. |
|
Le nom de stratégie spécifié n’existe pas. |
|
La définition d’option spécifiée n’existe pas sur la base de données du serveur DHCP. |
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer 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, consultezEnvoyer et afficher des commentaires pour