dhcpServerSetConfigV4 函式 (dhcpsapi.h)

  • 發行項

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

語法

DWORD DHCP_API_FUNCTION DhcpServerSetConfigV4(
  [in] DHCP_CONST WCHAR             *ServerIpAddress,
  [in] DWORD                        FieldsToSet,
  [in] LPDHCP_SERVER_CONFIG_INFO_V4 ConfigInfo
);

參數

[in] ServerIpAddress

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

[in] FieldsToSet

指定一組位旗標，指出 ConfigInfo 中的哪些欄位已設定。 如果旗標存在，則對應的欄位也必須填入ConfigInfo所參考的DHCP_SERVER_CONFIG_INFO_V4結構中，並用來在 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_DebugFlag
0x00000100
 已填入 DebugFlag 欄位。
Set_PingRetries
0x00000200
 [PingRetries]欄位已填入。
Set_BootFileTable
0x00000400
 [ BootFileTable] 欄位已填入。
Set_AuditLogState
0x00000800
 [ AuditLogState ] 欄位已填入。

[in] ConfigInfo

DHCP_SERVER_CONFIG_INFO_V4 結構，其中包含特定 DHCP 伺服器組態設定，如 FieldsToSet中設定的位旗標所表示。

傳回值

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

傳回碼 描述
ERROR_ACCESS_DENIED
 此呼叫是由不是「DHCP 系統管理員」安全性群組成員的用戶端所執行。
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器的資料庫時發生錯誤。
ERROR_INVALID_PARAMETER
 其中一個參數提供不正確值。

需求

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

另請參閱

DHCP_SERVER_CONFIG_INFO_V4

DhcpServerGetConfigV4