DHCP_SERVER_CONFIG_INFO_VQ 結構 (dhcpsapi.h)

  • 發行項

DHCP_SERVER_CONFIG_INFO_VQ結構會定義 DHCP 伺服器的設定。

語法

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;

成員

APIProtocolSupport

整數值，定義 DHCP 伺服器用來向 RPC 註冊的 RPC 通訊協定類型。 以下是一組支援的型別，可能是位 OR'd 來產生有效值。

值 意義
DHCP_SERVER_USE_RPC_OVER_TCPIP
0x00000001
 DHCP 伺服器會使用透過 TCP 的 RPC 通訊協定來註冊。
DHCP_SERVER_USE_RPC_OVER_NP
0x00000002
 DHCP 伺服器會使用透過命名管道的 RPC 通訊協定來註冊。<8>
DHCP_SERVER_USE_RPC_OVER_LPC
0x00000004
 DHCP 伺服器會使用透過 LPC 的 RPC 通訊協定來註冊。<9>
DHCP_SERVER_USE_RPC_OVER_ALL
0x00000007
 DHCP 伺服器支援上述所有通訊協定。

DatabaseName

Null 終止的 Unicode 字串指標，代表 DHCP 伺服器用於永續性記憶體的 DHCP 伺服器資料庫名稱。

DatabasePath

Null 終止 Unicode 字串的指標，其中包含儲存 DHCP 伺服器資料庫的絕對路徑。

BackupPath

Null 終止 Unicode 字串的指標，其中包含 DHCP 伺服器用於備份之備份記憶體的絕對路徑。

BackupInterval

整數值，指定 DHCP 伺服器資料庫備份之間的間隔分鐘數。

DatabaseLoggingFlag

整數值，表示 DHCP 伺服器的事務歷史記錄模式。 值 1 表示 DHCP 伺服器已啟用事務歷史記錄，而 0 表示 DHCP 伺服器的事務歷史記錄已停用。

RestoreFlag

用來做為 BOOL 旗標的整數值。 如果此設定為 TRUE (1) ，DHCP 服務會從 DHCP 服務啟動時的備份資料庫載入 DHCP 資料庫。 此旗標的預設值為 FALSE (0) 。

DatabaseCleanupInterval

整數值，指定允許 DOOMED IPv4 DHCP 用戶端記錄在 DHCP 伺服器資料庫中保存的最大時間間隔。

DebugFlag

整數旗標值，指定 DHCP 伺服器所完成的記錄層級。 下表定義可使用的集合值。 指定 『0xFFFFFFFF』 可啟用所有類型的記錄。

低字位掩碼 (0x0000FFFF) 低頻率偵錯輸出。

值 意義
DEBUG_ADDRESS
0x00000001
 啟用IP位址相關的記錄。
DEBUG_CLIENT
0x00000002
 啟用 DHCP-client-API 相關記錄。
DEBUG_PARAMETERS
0x00000004
 啟用 DHCP-server-parameters 相關記錄。
DEBUG_OPTIONS
0x00000008
 啟用 DHCP 選項相關的記錄。
DEBUG_ERRORS
0x00000010
 啟用 DHCP 錯誤相關的記錄。
DEBUG_STOC
0x00000020
 啟用 DHCPv4 和 DCHPv6-protocol-errors 相關記錄。
DEBUG_INIT
0x00000040
 啟用 DHCP-server-initialization-related logging。
DEBUG_SCAVENGER
0x00000080
 啟用 scavenger 的錯誤相關記錄。
DEBUG_TIMESTAMP
0x00000100
 啟用計時錯誤相關的記錄。
DEBUG_APIS
0x00000200
 啟用 DHCP-API 相關記錄。
DEBUG_REGISTRY
0x00000400
 啟用登錄設定作業所造成的錯誤記錄。
DEBUG_JET
0x00000800
 啟用 DHCP 伺服器資料庫錯誤的記錄。
DEBUG_THREADPOOL
0x00001000
 啟用與執行線程集區作業相關的記錄。
DEBUG_AUDITLOG
0x00002000
 啟用與稽核記錄作業所造成的錯誤相關的記錄。
DEBUG_QUARANTINE
0x00004000
 啟用隔離錯誤所造成的錯誤記錄。
DEBUG_MISC
0x00008000
 啟用其他錯誤所造成的記錄。
 

高 WORD 位掩碼 (0xFFFF0000) 高頻率偵錯輸出，也就是更詳細。

值 意義
DEBUG_MESSAGE
0x00010000
 啟用與偵錯訊息相關的記錄。
DEBUG_API_VERBOSE
0x00020000
 啟用與 DHCP API 詳細資訊錯誤相關的記錄。
DEBUG_DNS
0x00040000
 啟用與 DNS 訊息相關的記錄。
DEBUG_MSTOC
0x00080000
 啟用與多播通訊協定層錯誤相關的記錄。
DEBUG_TRACK
0x00100000
 啟用記錄追蹤特定問題。
DEBUG_ROGUE
0x00200000
 啟用與 ROGUE DHCP 伺服器相關的記錄。
DEBUG_PNP
0x00400000
 啟用與 PNP 介面錯誤相關的記錄。
DEBUG_PERF
0x01000000
 啟用效能相關訊息的記錄。
DEBUG_ALLOC
0x02000000
 啟用配置相關和解除分配相關訊息的記錄。
DEBUG_PING
0x04000000
 啟用同步 Ping 相關訊息的記錄。
DEBUG_THREAD
0x08000000
 啟用線程相關訊息的記錄。
DEBUG_TRACE
0x10000000
 啟用記錄以透過程式代碼訊息進行追蹤。
DEBUG_TRACE_CALLS
0x20000000
 啟用記錄以透過程式代碼的堆積進行追蹤。
DEBUG_STARTUP_BRK
0x40000000
 在安裝訊息期間啟用與調試程式中斷相關的記錄。
DEBUG_LOG_IN_FILE
0x80000000
 在檔案中啟用偵錯輸出的記錄。

dwPingRetries

整數值，指定 DHCP 伺服器可在發出任何位址給 DHCP 用戶端之前發出 ping 來驗證特定位址是否已在使用中的重試次數，再發出任何位址給 DHCP 用戶端 (有效範圍：0-5，包含) 。

cbBootTableString

整數值，其中包含提供給 DHCP 用戶端的 BOOT TABLE 大小。

wszBootTableString

Null 終止 Unicode 字串的指標，其中包含提供給 BOOTP 用戶端之 BOOTP TABLE 的絕對路徑。

fAuditLog

如果 為 TRUE，則會由 DHCP 伺服器寫入稽核記錄檔;如果 為 FALSE，則不會。

QuarantineOn

如果 為 TRUE，則會在 DHCP 伺服器上開啟隔離;如果 為 FALSE，則會關閉。

QuarDefFail

整數值，決定無法連線 NPS 伺服器時 DHCP NAP 伺服器的預設原則。 選擇包括隔離/不受限制/卸除要求。

QuarRuntimeStatus

如果 為 TRUE，則會在 DHCP 伺服器上啟用 NAP;如果 為 FALSE，則不是 。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 dhcpsapi.h