DhcpServerSetConfig, fonction (dhcpsapi.h)

  • Article

La fonction DhcpServerSetConfig configure un serveur DHCPv4 avec des paramètres spécifiques, notamment des informations sur la base de données JET utilisée pour stocker les informations de sous-réseau et de bail client, ainsi que les protocoles pris en charge.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpServerSetConfig(
  [in] DHCP_CONST WCHAR          *ServerIpAddress,
  [in] DWORD                     FieldsToSet,
  [in] LPDHCP_SERVER_CONFIG_INFO ConfigInfo
);

Paramètres

[in] ServerIpAddress

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

[in] FieldsToSet

Spécifie un ensemble d’indicateurs de bits qui indiquent les champs définis dans ConfigInfo . Si un indicateur est présent, le champ correspondant doit également être rempli dans la structure DHCP_SERVER_CONFIG_INFO référencée par ConfigInfo, et sera utilisé pour définir la même valeur sur le serveur DHCP,

Valeur Signification
Set_APIProtocolSupport
0x00000001
 Le champ APIProtocolSupport est renseigné.
Set_DatabaseName
0x00000002
 Le champ DatabaseName est renseigné.
Set_DatabasePath
0x00000004
 Le champ DatabasePath est renseigné.
Set_BackupPath
0x00000008
 Le champ BackupPath est renseigné.
Set_BackupInterval
0x00000010
 Le champ BackupInterval est rempli.
Set_DatabaseLoggingFlag
0x00000020
 Le champ DatabaseLoggingFlag est renseigné.
Set_RestoreFlag
0x00000040
 Le champ RestoreFlag est renseigné.
Set_DatabaseCleanupInterval
0x00000080
 Le champ DatabaseCleanupInterval est renseigné.
Set_Set_DebugFlag
0x00000100
 Le champ DebugFlag est renseigné.

[in] ConfigInfo

DHCP_SERVER_CONFIG_INFO structure qui contient les informations de configuration spécifiques à définir sur le serveur DHCP, comme indiqué par les indicateurs spécifiés dans FieldsToSet.

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.

Notes

Le serveur DHCPv4 doit être redémarré pour que les paramètres suivants soient effectifs :

  • Set_APIProtocolSupport
  • Set_DatabaseName
  • Set_DatabasePath
  • Set_DatabaseLoggingFlag
  • Set_RestoreFlag

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_SERVER_CONFIG_INFO

DhcpServerGetConfig

DhcpServerSetConfigV4