Fonction DhcpServerSetConfigV4 (dhcpsapi.h)

  • Article

La fonction DhcpServerSetConfigV4 configure un serveur DHCP 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 DhcpServerSetConfigV4(
  [in] DHCP_CONST WCHAR             *ServerIpAddress,
  [in] DWORD                        FieldsToSet,
  [in] LPDHCP_SERVER_CONFIG_INFO_V4 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 quels champs dans ConfigInfo sont définis. Si un indicateur est présent, le champ correspondant doit également être renseigné dans la structure DHCP_SERVER_CONFIG_INFO_V4 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 renseigné.
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_DebugFlag
0x00000100
 Le champ DebugFlag est renseigné.
Set_PingRetries
0x00000200
 Le champ PingRetries est renseigné.
Set_BootFileTable
0x00000400
 Le champ BootFileTable est renseigné.
Set_AuditLogState
0x00000800
 Le champ AuditLogState est renseigné.

[in] ConfigInfo

DHCP_SERVER_CONFIG_INFO_V4 structure qui contient les paramètres de configuration du serveur DHCP spécifiques, comme indiqué par les indicateurs de bits définis dans FieldsToSet.

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_ACCESS_DENIED
 Cet appel a été effectué par un client qui n’est pas membre du groupe de sécurité « Administrateurs DHCP ».
ERROR_DHCP_JET_ERROR
 Une erreur s’est produite lors de l’accès à la base de données du serveur DHCP.
ERROR_INVALID_PARAMETER
 L’un des paramètres fournit une valeur non valide.

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_V4

DhcpServerGetConfigV4