DHCP_SERVER_CONFIG_INFO_VQ structure (dhcpsapi.h)

  • Article

La structure DHCP_SERVER_CONFIG_INFO_VQ définit les paramètres du serveur DHCP.

Syntaxe

typedef struct _DHCP_SERVER_CONFIG_INFO_VQ {
  DWORD  APIProtocolSupport;
  LPWSTR DatabaseName;
  LPWSTR DatabasePath;
  LPWSTR BackupPath;
  DWORD  BackupInterval;
  DWORD  DatabaseLoggingFlag;
  DWORD  RestoreFlag;
  DWORD  DatabaseCleanupInterval;
  DWORD  DebugFlag;
  DWORD  dwPingRetries;
  DWORD  cbBootTableString;
  WCHAR  *wszBootTableString;
  BOOL   fAuditLog;
  BOOL   QuarantineOn;
  DWORD  QuarDefFail;
  BOOL   QuarRuntimeStatus;
} DHCP_SERVER_CONFIG_INFO_VQ, *LPDHCP_SERVER_CONFIG_INFO_VQ;

Membres

APIProtocolSupport

Valeur entière qui définit le type de protocole RPC utilisé par le serveur DHCP pour s’inscrire auprès de RPC. Voici l’ensemble des types pris en charge, qui peuvent être au niveau du bit OU pour produire des valeurs valides.

Valeur Signification
DHCP_SERVER_USE_RPC_OVER_TCPIP
0x00000001
 Le protocole RPC sur TCP est utilisé par le serveur DHCP pour l’inscription.
DHCP_SERVER_USE_RPC_OVER_NP
0x00000002
 Le protocole RPC sur les canaux nommés est utilisé par le serveur DHCP pour s’inscrire.<8>
DHCP_SERVER_USE_RPC_OVER_LPC
0x00000004
 Le protocole RPC sur LPC est utilisé par le serveur DHCP pour l’inscription.<9>
DHCP_SERVER_USE_RPC_OVER_ALL
0x00000007
 Le serveur DHCP prend en charge tous les protocoles précédents.

DatabaseName

Pointeur vers une chaîne Unicode terminée par null qui représente le nom de base de données du serveur DHCP utilisé par le serveur DHCP pour le stockage persistant.

DatabasePath

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le chemin absolu, où la base de données du serveur DHCP est stockée.

BackupPath

Pointeur vers une chaîne Unicode terminée par null qui contient le chemin absolu du stockage de sauvegarde utilisé par le serveur DHCP pour la sauvegarde.

BackupInterval

Valeur entière qui spécifie l’intervalle en minutes entre les sauvegardes de la base de données du serveur DHCP.

DatabaseLoggingFlag

Valeur entière qui indique le mode de journalisation des transactions du serveur DHCP. La valeur 1 indique que le journal des transactions est activé pour le serveur DHCP, et 0 indique que le journal des transactions est désactivé pour le serveur DHCP.

RestoreFlag

Valeur entière utilisée comme indicateur BOOL. Si ce paramètre a la valeur TRUE (1), le service DHCP charge la base de données DHCP à partir de la base de données de sauvegarde au démarrage du service DHCP. La valeur par défaut de cet indicateur est FALSE (0).

DatabaseCleanupInterval

Valeur entière qui spécifie l’intervalle de temps maximal pendant lequel les enregistrements clients DHCP IPv4 DOOMED sont autorisés à persister dans la base de données du serveur DHCP.

DebugFlag

Valeur de l’indicateur entier qui spécifie le niveau de journalisation effectué par le serveur DHCP. Le tableau suivant définit les valeurs définies qui peuvent être utilisées. La spécification de « 0xFFFFFFFF » active tous les types de journalisation.

Masque de bits LOW WORD (0x0000FFFF) pour la sortie de débogage à basse fréquence.

Valeur Signification
DEBUG_ADDRESS
0x00000001
 Activez la journalisation liée aux adresses IP.
DEBUG_CLIENT
0x00000002
 Activez la journalisation liée à DHCP-client-API.
DEBUG_PARAMETERS
0x00000004
 Activez la journalisation liée aux paramètres du serveur DHCP.
DEBUG_OPTIONS
0x00000008
 Activez la journalisation liée aux options DHCP.
DEBUG_ERRORS
0x00000010
 Activez la journalisation liée aux erreurs DHCP.
DEBUG_STOC
0x00000020
 Activez la journalisation liée aux erreurs de protocole DHCPv4 et DCHPv6.
DEBUG_INIT
0x00000040
 Activez la journalisation liée à l’initialisation du serveur DHCP.
DEBUG_SCAVENGER
0x00000080
 Activez la journalisation liée aux erreurs du scavenger.
DEBUG_TIMESTAMP
0x00000100
 Activez la journalisation liée aux erreurs de minutage.
DEBUG_APIS
0x00000200
 Activez la journalisation liée aux API DHCP.
DEBUG_REGISTRY
0x00000400
 Activez la journalisation des erreurs provoquées par les opérations de paramètre de Registre.
DEBUG_JET
0x00000800
 Activez la journalisation des erreurs de base de données du serveur DHCP.
DEBUG_THREADPOOL
0x00001000
 Activez la journalisation liée à l’exécution d’opérations de pool de threads.
DEBUG_AUDITLOG
0x00002000
 Activez la journalisation liée aux erreurs provoquées par les opérations de journal d’audit.
DEBUG_QUARANTINE
0x00004000
 Activez la journalisation des erreurs provoquées par des erreurs de mise en quarantaine.
DEBUG_MISC
0x00008000
 Activez la journalisation causée par diverses erreurs.
 

Masque de bits HIGH WORD (0xFFFF0000) pour la sortie de débogage haute fréquence, c’est-à-dire plus détaillée.

Valeur Signification
DEBUG_MESSAGE
0x00010000
 Activez la journalisation liée au débogage des messages.
DEBUG_API_VERBOSE
0x00020000
 Activez la journalisation liée aux erreurs détaillées de l’API DHCP.
DEBUG_DNS
0x00040000
 Activez la journalisation liée aux messages DNS.
DEBUG_MSTOC
0x00080000
 Activez la journalisation liée aux erreurs de couche de protocole de multidiffusion.
DEBUG_TRACK
0x00100000
 Activez les problèmes spécifiques de suivi de journalisation.
DEBUG_ROGUE
0x00200000
 Activez la journalisation liée à un serveur DHCP ROGUE.
DEBUG_PNP
0x00400000
 Activez la journalisation liée aux erreurs d’interface PNP.
DEBUG_PERF
0x01000000
 Activez la journalisation des messages liés aux performances.
DEBUG_ALLOC
0x02000000
 Activez la journalisation des messages liés à l’allocation et à la distribution.
DEBUG_PING
0x04000000
 Activez la journalisation des messages ping synchrones.
DEBUG_THREAD
0x08000000
 Activez la journalisation des messages liés aux threads.
DEBUG_TRACE
0x10000000
 Activez la journalisation pour le suivi via les messages de code.
DEBUG_TRACE_CALLS
0x20000000
 Activez la journalisation pour le suivi via des piles de code.
DEBUG_STARTUP_BRK
0x40000000
 Activez la journalisation liée à l’arrêt du débogueur pendant les messages d’installation.
DEBUG_LOG_IN_FILE
0x80000000
 Activez la journalisation de la sortie de débogage dans un fichier.

dwPingRetries

Valeur entière qui spécifie le nombre de nouvelles tentatives que le serveur DHCP peut effectuer pour vérifier si une adresse particulière est déjà utilisée par un client en émettant un test ping avant d’émettre une adresse au client DHCP (plage valide : de 0 à 5, inclus).

cbBootTableString

Valeur entière qui contient la taille de la TABLE DE DÉMARRAGE donnée au client DHCP.

wszBootTableString

Pointeur vers une chaîne Unicode terminée par null qui contient le chemin d’accès absolu de la TABLE BOOTP donnée au client BOOTP.

fAuditLog

Si la valeur est TRUE, un journal d’audit est écrit par le serveur DHCP ; si la valeur est FALSE, ce n’est pas le cas.

QuarantineOn

Si la valeur est TRUE, la mise en quarantaine est activée sur le serveur DHCP ; si la valeur est FALSE, elle est désactivée.

QuarDefFail

Valeur entière qui détermine la stratégie par défaut d’un serveur NAP DHCP lorsqu’un serveur NPS n’est pas accessible. Les choix incluent quarantaine/sans restriction/suppression de la demande.

QuarRuntimeStatus

Si la valeur est TRUE, NAP est activée sur le serveur DHCP ; si la valeur est FALSE, ce n’est pas le cas.

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]
En-tête dhcpsapi.h