dhcpAddSubnetElementV4 函式 (dhcpsapi.h)

  • 發行項

DhcpAddSubnetElementV4函式會將描述子網功能或層面的專案新增至 DHCP 資料庫中的子網專案。 此函式會藉由納入考慮用戶端類型的子網元素來擴充 DhcpAddSubnetElement 。

注意 此函式不適用於 Windows NT 4.0 Service Pack 1 之前的 Windows。
 

語法

DWORD DHCP_API_FUNCTION DhcpAddSubnetElementV4(
  [in] DHCP_CONST WCHAR                       *ServerIpAddress,
  [in] DHCP_IP_ADDRESS                        SubnetAddress,
  [in] DHCP_CONST DHCP_SUBNET_ELEMENT_DATA_V4 *AddElementInfo
);

參數

[in] ServerIpAddress

Unicode 字串的指標，其中包含子網 DHCP 伺服器的 IP 位址。

[in] SubnetAddress

DHCP_IP_ADDRESS 結構，其中包含子網的 IP 位址。

[in] AddElementInfo

DHCP_SUBNET_ELEMENT_DATA_V4 結構，其中包含要加入至子網的專案資料。 V4 結構新增了 DHCP 和 BOOTP 用戶端之間的差異支援。

傳回值

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

傳回碼 描述
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器資料庫時發生錯誤。
ERROR_DHCP_SUBNET_NOT_PRESENT
 指定的 IPv4 子網不存在。
ERROR_DHCP_OPTION_NOT_PRESENT
 指定的選項定義不存在於 DHCP 伺服器資料庫中。
ERROR_DHCP_INVALID_RANGE
 指定的 IPv4 位址範圍會重迭現有的範圍或無效。
ERROR_DHCP_IPRANGE_CONV_ILLEGAL
 當 DHCPv4 和 BOOTP 用戶端存在於要轉換的範圍內時，不允許將範圍轉換成僅限 DHCPv4 範圍或僅限 BOOTP 的範圍。 根據所建立的範圍類型，手動刪除 DHCPv4 或 BOOTP 用戶端。
ERROR_DHCP_IPRANGE_EXISTS
 指定的 IPv4 位址範圍已經存在。
ERROR_DHCP_MSCOPE_RANGE_TOO_SMALL
 多播範圍必須允許至少 256 個 IPv4 位址。
ERROR_DHCP_NOT_RESERVED_CLIENT
 指定的 DHCPv4 用戶端不是 IPv4 reserverdclient。
ERROR_DHCP_RESERVEDIP_EXISTS
 指定的 IPv4 位址或硬體位址正由另一個 DHCPv4 用戶端使用。
ERROR_DHCP_ADDRESS
 指定的位址無法使用。

需求

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

另請參閱

DHCP_SUBNET_ELEMENT_DATA_V4

DhcpAddSubnetElement

DhcpAddSubnetElementV5