DhcpV4AddPolicyRange 函式 (dhcpsapi.h)

發行項
02/28/2024

DhcpV4AddPolicyRange 函式會將IP位址範圍新增至原則。

語法

DWORD DHCP_API_FUNCTION DhcpV4AddPolicyRange(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in]           LPWSTR          PolicyName,
  [in]           LPDHCP_IP_RANGE Range
);

參數

[in, optional] ServerIpAddress

代表 DHCP 伺服器的 IP 位址或主機名的 Null 終止 Unicode 字串指標。

[in] SubnetAddress

DHCP_IP_ADDRESS 結構，其中包含要新增之原則 IP 位址範圍的 IPv4 子網位址。

[in] PolicyName

Null 終止的 Unicode 字串，表示要加入的原則 IP 位址範圍名稱。

[in] Range

包含要加入之原則 IP 位址範圍的 DHCP_IP_RANGE 結構的指標。

傳回值

如果函式成功，它會傳回 ERROR_SUCCESS。

如果函式失敗，它會從 DHCP 伺服器管理 API 錯誤碼傳回下列其中一個錯誤碼或錯誤碼。

值	意義
ERROR_DHCP_SUBNET_NOT_PRESENT	指定的 IPv4 子網不存在。
ERROR_DHCP_POLICY_NOT_FOUND	指定的原則不存在。
ERROR_DHCP_POLICY_RANGE_EXISTS	指定的原則 IP 範圍會與指定的其中一個原則 IP 位址範圍重疊。
ERROR_DHCP_POLICY_RANGE_BAD	指定的原則 IP 範圍不包含在範圍的 IP 位址範圍內，或指定的原則 IP 範圍無效。

規格需求

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