DhcpCreateOption, fonction (dhcpsapi.h)

  • Article

La fonction DhcpCreateOption crée une définition d’option pour la classe d’utilisateur et de fournisseur par défaut au niveau de l’option par défaut.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpCreateOption(
  [in] DHCP_CONST WCHAR       *ServerIpAddress,
  [in] DHCP_OPTION_ID         OptionID,
  [in] DHCP_CONST DHCP_OPTION *OptionInfo
);

Paramètres

[in] ServerIpAddress

Chaîne Unicode contenant l’adresse IPv4 du serveur DHCP.

[in] OptionID

DHCP_OPTION_ID valeur qui contient le numéro d’ID d’option unique (également appelé « code d’option ») de la nouvelle option. 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 dans Options DHCP et Extensions de fournisseur BOOTP.

[in] OptionInfo

DHCP_OPTION structure qui contient des informations décrivant la nouvelle option DHCP, y compris le nom, un commentaire facultatif et tous les éléments de données associés.

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_DHCP_JET_ERROR
 Une erreur s’est produite lors de l’accès à la base de données du serveur DHCP.
ERROR_DHCP_OPTION_EXISTS
 La définition d’option spécifiée existe déjà dans la base de données du serveur DHCP.

Remarques

Une option est un paramètre de configuration client attribué par un serveur DHCP aux clients DHCP et BOOTP. Par exemple, certaines options couramment utilisées incluent les adresses IP pour les passerelles (routeurs de sous-réseau), les serveurs WINS et les serveurs DNS. En règle générale, ces options sont activées et configurées pour une étendue particulière, mais des options par défaut peuvent être créées pour toutes les étendues prises en charge par un serveur DHCP donné.

Configuration requise

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

Voir aussi

DHCP_OPTION_ID

DhcpCreateOptionV5