Expand Minimize

DHCP_SERVER_CONFIG_INFO_VQ structure

The DHCP_SERVER_CONFIG_INFO_VQ structure defines settings for the DHCP server.

Syntax


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, *PDHCP_SERVER_CONFIG_INFO_VQ;

Members

APIProtocolSupport

Integer value that defines the type of RPC protocol used by the DHCP server to register with RPC. Following is the set of supported types, which may be bitwise OR'd to produce valid values.

ValueMeaning
DHCP_SERVER_USE_RPC_OVER_TCPIP
0x00000001

RPC protocol over TCP is used by the DHCP server to register.

DHCP_SERVER_USE_RPC_OVER_NP
0x00000002

RPC protocol over named pipes is used by the DHCP server to register.<8>

DHCP_SERVER_USE_RPC_OVER_LPC
0x00000004

RPC protocol over LPC is used by the DHCP server to register.<9>

DHCP_SERVER_USE_RPC_OVER_ALL
0x00000007

The DHCP server supports all of the preceding protocols.

 

DatabaseName

Pointer to a null-terminated Unicode string that represents the DHCP server database name that is used by the DHCP server for persistent storage.

DatabasePath

Pointer to a null-terminated Unicode string that contains the absolute path, where the DHCP server database is stored.

BackupPath

Pointer to a null-terminated Unicode string that contains the absolute path for backup storage that is used by the DHCP server for backup.

BackupInterval

Integer value that specifies the interval in minutes between backups of the DHCP server database.

DatabaseLoggingFlag

Integer value that indicates the transaction logging mode of the DHCP server. The value 1 indicates that the transaction log is enabled for the DHCP server, and 0 indicates that the transaction log is disabled for the DHCP server.

RestoreFlag

Integer value used as a BOOL flag. If this setting is TRUE (1), the DHCP service loads the DHCP database from the backup database on DHCP service startup. The default value of this flag is FALSE (0).

DatabaseCleanupInterval

Integer value that specifies the maximum time interval that DOOMED IPv4 DHCP client records are allowed to persist within the DHCP server database.

DebugFlag

Integer flag value that specifies the level of logging done by the DHCP server. The following table defines the set values that can be used. Specifying '0xFFFFFFFF' enables all types of logging.

LOW WORD bitmask (0x0000FFFF) for low-frequency debug output.

ValueMeaning
DEBUG_ADDRESS
0x00000001

Enable IP-address-related logging.

DEBUG_CLIENT
0x00000002

Enable DHCP-client-API-related logging.

DEBUG_PARAMETERS
0x00000004

Enable DHCP-server-parameters-related logging.

DEBUG_OPTIONS
0x00000008

Enable DHCP-options-related logging.

DEBUG_ERRORS
0x00000010

Enable DHCP-errors-related logging.

DEBUG_STOC
0x00000020

Enable DHCPv4 and DCHPv6-protocol-errors-related logging.

DEBUG_INIT
0x00000040

Enable DHCP-server-initialization-related logging.

DEBUG_SCAVENGER
0x00000080

Enable scavenger's-error-related logging.

DEBUG_TIMESTAMP
0x00000100

Enable timing-errors-related logging.

DEBUG_APIS
0x00000200

Enable DHCP-APIs-related logging.

DEBUG_REGISTRY
0x00000400

Enable the logging of errors caused by registry setting operations.

DEBUG_JET
0x00000800

Enable the logging of the DHCP server database errors.

DEBUG_THREADPOOL
0x00001000

Enable the logging related to executing thread pool operations.

DEBUG_AUDITLOG
0x00002000

Enable the logging related to errors caused by audit log operations.

DEBUG_QUARANTINE
0x00004000

Enable the logging of errors caused by quarantine errors.

DEBUG_MISC
0x00008000

Enable the logging caused by miscellaneous errors.

 

HIGH WORD bitmask (0xFFFF0000) for high-frequency debug output, that is, more verbose.

ValueMeaning
DEBUG_MESSAGE
0x00010000

Enable the logging related to debug messages.

DEBUG_API_VERBOSE
0x00020000

Enable the logging related to DHCP API verbose errors.

DEBUG_DNS
0x00040000

Enable the logging related to DNS messages.

DEBUG_MSTOC
0x00080000

Enable the logging related to multicast protocol layer errors.

DEBUG_TRACK
0x00100000

Enable the logging tracking specific problems.

DEBUG_ROGUE
0x00200000

Enable the logging related to a ROGUE DHCP server.

DEBUG_PNP
0x00400000

Enable the logging related to PNP interface errors.

DEBUG_PERF
0x01000000

Enable the logging of performance-related messages.

DEBUG_ALLOC
0x02000000

Enable the logging of allocation-related and deallocation-related messages.

DEBUG_PING
0x04000000

Enable the logging of synchronous ping–related messages.

DEBUG_THREAD
0x08000000

Enable the logging of thread-related messages.

DEBUG_TRACE
0x10000000

Enable the logging for tracing through code messages.

DEBUG_TRACE_CALLS
0x20000000

Enable the logging for tracing through piles of code.

DEBUG_STARTUP_BRK
0x40000000

Enable the logging related to debugger break during setup messages.

DEBUG_LOG_IN_FILE
0x80000000

Enable the logging of debug output in a file.

 

dwPingRetries

Integer value that specifies the number of retries that the DHCP server can make to verify whether a particular address is already in use by any client by issuing a ping before issuing any address to the DHCP client (valid range: 0–5, inclusive).

cbBootTableString

Integer value that contains the size of the BOOT TABLE given to the DHCP client.

wszBootTableString

Pointer to a null-terminated Unicode string that contains the absolute path of the BOOTP TABLE given to the BOOTP client.

fAuditLog

If TRUE, an audit log will be written by the DHCP server; if FALSE, it will not.

QuarantineOn

If TRUE, Quarantine is turned ON on the DHCP server; if FALSE, it is turned OFF.

QuarDefFail

Integer value that determines the default policy for a DHCP NAP server when an NPS server is not reachable. Choices include Quarantine/unrestricted/Drop Request.

QuarRuntimeStatus

If TRUE, NAP is enabled on the DHCP server; if FALSE, it is not.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Dhcpsapi.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft