Fonction DhcpSetOptionValues (dhcpsapi.h)

  • Article

La fonction DhcpSetOptionValues définit les codes d’option et les valeurs de données associées pour une étendue spécifique définie sur le serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpSetOptionValues(
  [in] DHCP_CONST WCHAR                   *ServerIpAddress,
  [in] DHCP_CONST DHCP_OPTION_SCOPE_INFO  *ScopeInfo,
  [in] DHCP_CONST DHCP_OPTION_VALUE_ARRAY *OptionValues
);

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

Pointeur vers une structure de DHCP_OPTION_SCOPE_INFO qui contient des informations décrivant le niveau (par défaut, serveur, étendue ou réservation IPv4) auquel cette valeur d’option sera définie.

[in] OptionValues

Pointeur vers une structure de DHCP_OPTION_VALUE_ARRAY qui contient une liste de codes d’option et la valeur de données correspondante qui sera définie pour eux.

Valeur retournée

Cette fonction retourne ERROR_SUCCESS en cas d’appel réussi. Sinon, il 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_NOT_PRESENT
 La définition d’option spécifiée est introuvable dans la base de données du serveur DHCP.
ERROR_DHCP_SUBNET_NOT_PRESENT
 Le sous-réseau IPv4 spécifié n’existe pas sur le serveur DHCP.
ERROR_DHCP_NOT_RESERVED_CLIENT
 Le client DHCP spécifié n’est pas un client réservé.
ERROR_FILE_NOT_FOUND
 L’étendue de multidiffusion spécifiée dans ScopeInfo est introuvable sur le serveur DHCP.

Notes

Lorsque cette fonction est appelée pour la première fois, elle crée les valeurs d’option fournies dans la base de données du serveur DHCP. Sinon, il modifie les valeurs d’option d’une ou plusieurs options associées à la classe d’utilisateur et à la classe fournisseur par défaut. Ces valeurs peuvent être définies pour le niveau de réservation par défaut, serveur, étendue ou IPv4 sur le serveur DHCP.

Spécifications

   
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_SCOPE_INFO

DHCP_OPTION_VALUE_ARRAY

DhcpSetOptionValue

DhcpSetOptionValuesV5