dhcpServerSetConfig 函式 (dhcpsapi.h)

  • 發行項

DhcpServerSetConfig函式會設定具有特定設定的 DHCPv4 伺服器，包括用來儲存子網和用戶端租用資訊的 JET 資料庫資訊，以及支援的通訊協定。

語法

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

參數

[in] ServerIpAddress

指定 DHCP 伺服器的 IP 位址或主機名稱的 Unicode 字串。

[in] FieldsToSet

指定一組位旗標，指出 ConfigInfo 中的哪些欄位已設定。 如果旗標存在，則對應的欄位也必須填入ConfigInfo所參考的DHCP_SERVER_CONFIG_INFO結構中，並用來在 DHCP 伺服器上設定相同的值。

值 意義
Set_APIProtocolSupport
0x00000001
 已填入 [APIProtocolSupport ] 欄位。
Set_DatabaseName
0x00000002
 [DatabaseName] 欄位已填入。
Set_DatabasePath
0x00000004
 [DatabasePath] 欄位已填入。
Set_BackupPath
0x00000008
 [ BackupPath ] 欄位已填入。
Set_BackupInterval
0x00000010
 [BackupInterval] 欄位已填入。
Set_DatabaseLoggingFlag
0x00000020
 [DatabaseLoggingFlag] 欄位已填入。
Set_RestoreFlag
0x00000040
 [RestoreFlag] 欄位已填入。
Set_DatabaseCleanupInterval
0x00000080
 [DatabaseCleanupInterval] 欄位已填入。
Set_Set_DebugFlag
0x00000100
 [ DebugFlag ] 欄位已填入。

[in] ConfigInfo

DHCP_SERVER_CONFIG_INFO 結構，其中包含在 DHCP 伺服器上設定的特定組態資訊，如 FieldsToSet中指定的旗標所表示。

傳回值

此函式會在成功呼叫時傳回 ERROR_SUCCESS 。 否則，它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。

備註

必須重新開機 DHCPv4 伺服器，下列設定才能生效：

  • Set_APIProtocolSupport
  • Set_DatabaseName
  • Set_DatabasePath
  • Set_DatabaseLoggingFlag
  • Set_RestoreFlag

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 dhcpsapi.h
程式庫 Dhcpsapi.lib
Dll Dhcpsapi.dll

另請參閱

DHCP_SERVER_CONFIG_INFO

DhcpServerGetConfig

DhcpServerSetConfigV4