dhcpRemoveSubnetElementV4 函式 (dhcpsapi.h)

  • 發行項

DhcpRemoveSubnetElementV4函式會從 DHCPv4 伺服器上定義的 IPv4 子網中移除 IPv4 子網元素。 函式會藉由允許包含用戶端類型的子網規格， (DHCP 或 BOOTP) 資訊，來擴充 DhcpRemoveSubnetElement 所提供的功能。

語法

DWORD DHCP_API_FUNCTION DhcpRemoveSubnetElementV4(
  [in] DHCP_CONST WCHAR                       *ServerIpAddress,
  [in] DHCP_IP_ADDRESS                        SubnetAddress,
  [in] DHCP_CONST DHCP_SUBNET_ELEMENT_DATA_V4 *RemoveElementInfo,
  [in] DHCP_FORCE_FLAG                        ForceFlag
);

參數

[in] ServerIpAddress

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

[in] SubnetAddress

DHCP_IP_ADDRESS 值，指定子網閘道的 IP 位址，並唯一識別它。

[in] RemoveElementInfo

DHCP_SUBNET_ELEMENT_DATA_V4 結構，其中包含用來尋找要從 SubnetAddress中指定的子網中移除之元素的資訊。

[in] ForceFlag

DHCP_FORCE_FLAG 列舉值，指出是否也應該刪除受到移除子網元素影響的用戶端。

注意 如果旗標設定為 DhcpNoForce ，且此子網已將 IPv4 位址提供給 DHCPv4/BOOTP 用戶端，則不會刪除 IPv4 範圍;相反地，如果旗標設定為 DhcpFullForce，則會刪除 IPv4 範圍以及 DHCPv4 伺服器上的 DHCPv4 用戶端租用記錄。
 

傳回值

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

傳回碼 描述
ERROR_DHCP_JET_ERROR
 存取 DHCP 伺服器資料庫時發生錯誤。
ERROR_DHCP_SUBNET_NOT_PRESENT
 DHCP 伺服器上未定義指定的 IPv4 子網。
ERROR_DHCP_RESERVED_CLIENT
 指定的 DHCP 用戶端是保留的用戶端。
ERROR_DHCP_INVALID_RANGE
 指定的 IPv4 位址範圍會重迭現有的 IPv4 位址範圍，或無效。
ERROR_DHCP_ELEMENT_CANT_REMOVE
 至少有一個多播 IPv4 位址已租用給 MADCAP 用戶端。

需求

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

另請參閱

DHCP_FORCE_FLAG

DHCP_SUBNET_ELEMENT_DATA_V4

DhcpAddSubnetElementV4