Función DhcpRemoveOptionV5 (dhcpsapi.h)

La función DhcpRemoveOptionV5 quita la definición de una opción específica para una clase de usuario específica y una clase de proveedor en el nivel de opción predeterminado en el servidor DHCP. Esto amplía la funcionalidad en DhcpRemoveOption con compatibilidad con nombres específicos de clase y proveedor.

Sintaxis

DWORD DhcpRemoveOptionV5(
  [in] LPWSTR         ServerIpAddress,
  [in] DWORD          Flags,
  [in] DHCP_OPTION_ID OptionID,
  [in] LPWSTR         ClassName,
  [in] LPWSTR         VendorName
);

Parámetros

[in] ServerIpAddress

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

[in] Flags

Especifica una marca de bits que indica si la opción es específica del proveedor o no. Si no es así, este parámetro debe ser 0.

Valor	Significado
0x00000000	Esta marca debe establecerse si la opción se quita para la clase de proveedor predeterminada.
DHCP_FLAGS_OPTION_IS_VENDOR 0x00000003	Esta marca debe establecerse si la opción se quita para una clase de proveedor específica.

[in] OptionID

DHCP_OPTION_ID valor que especifica el código de la opción que se va a quitar.

[in] ClassName

Cadena Unicode que especifica el nombre de clase DHCP de la opción. Este parámetro es opcional.

[in] VendorName

Cadena Unicode que especifica el proveedor de la opción. Este parámetro es opcional y debe ser NULL cuando Flags no está establecido en DHCP_FLAGS_OPTION_IS_VENDOR.

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_ACCESS_DENIED	Esta llamada la realizó un cliente que no es miembro del grupo de seguridad "Administradores DHCP".
ERROR_DHCP_JET_ERROR	Error al acceder a la base de datos del servidor DHCP.
ERROR_DHCP_OPTION_NOT_PRESENT	La definición de opción especificada no existe en la base de datos del servidor DHCP.
ERROR_DHCP_CLASS_NOT_FOUND	El nombre de clase proporcionado es desconocido o incorrecto.

Requisitos

Requisito	Value
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

DhcpCreateOptionV5