Función DhcpRemoveSubnetElement (dhcpsapi.h)

La función DhcpRemoveSubnetElement quita un elemento de subred IPv4 de una subred IPv4 definida en el servidor DHCPv4.

Sintaxis

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
);

Parámetros

[in] ServerIpAddress

Cadena Unicode que especifica la dirección IP o el nombre de host del servidor DHCPv4.

[in] SubnetAddress

DHCP_IP_ADDRESS valor que especifica la dirección IPv4 de la puerta de enlace de subred desde la que se van a quitar los elementos.

[in] RemoveElementInfo

DHCP_SUBNET_ELEMENT_DATA estructura que contiene información utilizada para buscar el elemento que se quitará de la subred especificada en SubnetAddress.

[in] ForceFlag

DHCP_FORCE_FLAG valor de enumeración que indica si los clientes afectados por la eliminación del elemento de subred también deben eliminarse.

Nota Si la marca está establecida en DhcpNoForce y esta subred ha servido una dirección IPv4 a los clientes DHCPv4/BOOTP, el intervalo IPv4 no se elimina; por el contrario, si la marca está establecida en DhcpFullForce, el intervalo IPv4 se elimina junto con el registro de concesión de cliente DHCPv4 en el servidor DHCPv4.

 

Valor devuelto

Esta función devuelve ERROR_SUCCESS tras una llamada correcta. De lo contrario, devuelve uno de los códigos de error de la API de administración del servidor DHCP.

Código devuelto	Descripción
ERROR_DHCP_JET_ERROR	Error al acceder a la base de datos del servidor DHCP.
ERROR_DHCP_SUBNET_NOT_PRESENT	La subred IPv4 especificada no está definida en el servidor DHCP.
ERROR_DHCP_RESERVED_CLIENT	El cliente DHCP especificado es un cliente reservado.
ERROR_DHCP_INVALID_RANGE	El intervalo de direcciones IPv4 especificado se superpone a un intervalo de direcciones IPv4 existente o no es válido.
ERROR_DHCP_ELEMENT_CANT_REMOVE	Se ha concedido al menos una dirección IPv4 de multidifusión a un cliente MADCAP.

Requisitos

Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dhcpsapi.h
Library	Dhcpsapi.lib
Archivo DLL	Dhcpsapi.dll

Consulte también

DHCP_FORCE_FLAG

DHCP_SUBNET_ELEMENT_DATA

DhcpAddSubnetElement