Fonction DhcpSetOptionValues (dhcpsapi.h)
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 |
---|---|
|
Une erreur s’est produite lors de l’accès à la base de données du serveur DHCP. |
|
La définition d’option spécifiée est introuvable dans la base de données du serveur DHCP. |
|
Le sous-réseau IPv4 spécifié n’existe pas sur le serveur DHCP. |
|
Le client DHCP spécifié n’est pas un client réservé. |
|
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 |