DhcpSetOptionValueV6, fonction (dhcpsapi.h)

Article
08/23/2023

La fonction DhcpSetOptionValueV6 définit des informations pour une valeur d’option spécifique sur le serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpSetOptionValueV6(
  [in] LPWSTR                    ServerIpAddress,
  [in] DWORD                     Flags,
  [in] DHCP_OPTION_ID            OptionId,
  [in] LPWSTR                    ClassName,
  [in] LPWSTR                    VendorName,
  [in] LPDHCP_OPTION_SCOPE_INFO6 ScopeInfo,
  [in] LPDHCP_OPTION_DATA        OptionValue
);

Paramètres

[in] ServerIpAddress

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

[in] Flags

Spécifie un indicateur de bits qui indique si l’option est spécifique au fournisseur. Si ce n’est pas le cas, ce paramètre doit être 0.

Valeur	Signification
DHCP_FLAGS_OPTION_IS_VENDOR	Cet indicateur doit être défini si l’option est fournie par un fournisseur.

[in] OptionId

DHCP_OPTION_ID valeur qui contient le numéro d’ID d’option unique (également appelé « code d’option ») de l’option en cours de définition. La plupart de ces numéros d’id d’option sont définis ; Vous trouverez la liste complète des codes d’option DHCP et BOOTP standard à l’adresse http://www.ietf.org/rfc/rfc2132.txt.

[in] ClassName

Chaîne Unicode qui spécifie la classe DHCP de l’option. Ce paramètre est facultatif.

[in] VendorName

Chaîne Unicode qui spécifie le fournisseur de l’option. Ce paramètre est facultatif et doit avoir la valeur NULL lorsque Indicateurs n’est pas défini sur DHCP_FLAGS_OPTION_IS_VENDOR.

[in] ScopeInfo

Pointeur vers une structure DHCP_OPTION_SCOPE_INFO6 qui contient des informations décrivant l’étendue DHCP sur laquelle cette valeur d’option sera définie.

[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

Cette fonction retourne ERROR_SUCCESS en cas d’appel réussi. Sinon, elle retourne l’un des codes d’erreur de l’API Gestion du serveur DHCP.

Code de retour	Description
ERROR_INVALID_PARAMETER	Les paramètres n’étaient pas valides.
ERROR_DHCP_OPTION_NOT_PRESENT	L’option spécifiée n’est pas présente sur le serveur DHCP.

Spécifications


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