Función DhcpAddSubnetElementV4 (dhcpsapi.h)

La función DhcpAddSubnetElementV4 agrega un elemento que describe una característica o un aspecto de la subred a la entrada de subred en la base de datos DHCP. Esta función extiende DhcpAddSubnetElement mediante la incorporación de elementos de subred que consideran el tipo de cliente.

Nota Esta función no está disponible en Windows anterior a Windows NT 4.0 Service Pack 1.

 

Sintaxis

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

Parámetros

[in] ServerIpAddress

Puntero a una cadena Unicode que contiene la dirección IP del servidor DHCP de subred.

[in] SubnetAddress

DHCP_IP_ADDRESS estructura que contiene la dirección IP de la subred.

[in] AddElementInfo

DHCP_SUBNET_ELEMENT_DATA_V4 estructura que contiene los datos de elemento que se van a agregar a la subred. La estructura V4 agrega compatibilidad para la diferenciación entre los clientes DHCP y BOOTP.

Valor devuelto

Esta función devuelve ERROR_SUCCESS 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 existe.
ERROR_DHCP_OPTION_NOT_PRESENT	La definición de opción especificada no existe en la base de datos del servidor DHCP.
ERROR_DHCP_INVALID_RANGE	El intervalo de direcciones IPv4 especificado se superpone a un intervalo existente o no es válido.
ERROR_DHCP_IPRANGE_CONV_ILLEGAL	No se permite la conversión de un ámbito a un ámbito de solo DHCPv4 o a un ámbito de solo BOOTP cuando los clientes DHCPv4 y BOOTP están presentes en el ámbito que se va a convertir. Elimine manualmente los clientes DHCPv4 o BOOTP del ámbito, según corresponda para el tipo de ámbito que se va a crear.
ERROR_DHCP_IPRANGE_EXISTS	El intervalo de direcciones IPv4 especificado ya existe.
ERROR_DHCP_MSCOPE_RANGE_TOO_SMALL	El intervalo de ámbito de multidifusión debe permitir al menos 256 direcciones IPv4.
ERROR_DHCP_NOT_RESERVED_CLIENT	El cliente DHCPv4 especificado no es un reserverdclient IPv4.
ERROR_DHCP_RESERVEDIP_EXISTS	Otro cliente DHCPv4 usa la dirección IPv4 especificada o la dirección de hardware.
ERROR_DHCP_ADDRESS	La dirección especificada no está disponible.

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_SUBNET_ELEMENT_DATA_V4

DhcpAddSubnetElement

DhcpAddSubnetElementV5