DhcpRemoveSubnetElement 函式 (dhcpsapi.h)
DhcpRemoveSubnetElement函式會從 DHCPv4 伺服器上定義的 IPv4 子網中移除 IPv4 子網元素。
語法
DWORD DHCP_API_FUNCTION DhcpRemoveSubnetElement(
[in] DHCP_CONST WCHAR *ServerIpAddress,
[in] DHCP_IP_ADDRESS SubnetAddress,
[in] DHCP_CONST DHCP_SUBNET_ELEMENT_DATA *RemoveElementInfo,
[in] DHCP_FORCE_FLAG ForceFlag
);
參數
[in] ServerIpAddress
指定 DHCPv4 伺服器的 IP 位址或主機名稱的 Unicode 字串。
[in] SubnetAddress
DHCP_IP_ADDRESS 值,指定要從中移除元素的子網閘道 IPv4 位址。
[in] RemoveElementInfo
DHCP_SUBNET_ELEMENT_DATA 結構,其中包含用來尋找要從 SubnetAddress中指定的子網中移除之元素的資訊。
[in] ForceFlag
DHCP_FORCE_FLAG 列舉值,指出是否也應該刪除受移除子網元素影響的用戶端。
注意 如果旗標設定為 DhcpNoForce ,且此子網已將 IPv4 位址提供給 DHCPv4/BOOTP 用戶端,則不會刪除 IPv4 範圍;相反地,如果旗標設定為 DhcpFullForce,則會刪除 IPv4 範圍以及 DHCPv4 伺服器上的 DHCPv4 用戶端租用記錄。
傳回值
此函式會在成功呼叫時傳回 ERROR_SUCCESS 。 否則,它會傳回其中一個 DHCP 伺服器管理 API 錯誤碼。
傳回碼 | 描述 |
---|---|
|
存取 DHCP 伺服器資料庫時發生錯誤。 |
|
DHCP 伺服器上未定義指定的 IPv4 子網。 |
|
指定的 DHCP 用戶端是保留的用戶端。 |
|
指定的 IPv4 位址範圍會與現有的 IPv4 位址範圍重迭,或無效。 |
|
至少有一個多播 IPv4 位址已租用給 MADCAP 用戶端。 |
需求
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | dhcpsapi.h |
程式庫 | Dhcpsapi.lib |
Dll | Dhcpsapi.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應