Compartir a través de


Función DeleteUnicastIpAddressEntry

La función DeleteUnicastIpAddressEntry elimina una entrada de dirección IP de unidifusión existente en un equipo local.

Sintaxis

NETIOAPI_API DeleteUnicastIpAddressEntry(
  _In_ const MIB_UNICASTIPADDRESS_ROW *Row
);

Parámetros

Valor devuelto

DeleteUnicastIpAddressEntry devuelve STATUS_SUCCESS si la función se realiza correctamente.

Si se produce un error en la función, DeleteUnicastIpAddressEntry devuelve uno de los siguientes códigos de error:

Código devuelto Descripción
STATUS_INVALID_PARAMETER

Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un puntero NULL en el parámetro Row , el miembro Address de la estructura MIB_UNICASTIPADDRESS_ROW a la que apunta el parámetro Row no se estableció en una dirección IPv4 o IPv6 de unidifusión válida, o los miembros InterfaceLuid e InterfaceIndex de la estructura de MIB_UNICASTIPADDRESS_ROW no se especificaron.

STATUS_NOT_FOUND

No se encontró la interfaz especificada. Este error se devuelve si la función no encuentra la interfaz de red especificada por el miembro InterfaceLuid o InterfaceIndex de la estructura MIB_UNICASTIPADDRESS_ROW a la que apunta el parámetro Row .

STATUS_NOT_SUPPORTED

No se admite la solicitud. Este error se devuelve si no se encuentra ninguna pila IPv4 en el equipo local y se especificó una dirección IPv4 en el miembro Address de la estructura MIB_UNICASTIPADDRESS_ROW a la que apunta el parámetro Row , o si no se encuentra ninguna pila IPv6 en el equipo local y se especificó una dirección IPv6 en el miembro Address .

Otros

Use la función FormatMessage para obtener la cadena de mensaje del error devuelto.

Observaciones

La función DeleteUnicastIpAddressEntry se usa para eliminar una entrada de estructura de MIB_UNICASTIPADDRESS_ROW existente en el equipo local.

En la entrada, el controlador debe inicializar los siguientes miembros de la estructura MIB_UNICASTIPADDRESS_ROW a la que apunta el parámetro Row .

  • Dirección
    Establézcalo en una dirección y familia de unidifusión IPv4 o IPv6 válida.

  • InterfaceLuid o InterfaceIndex
    Estos miembros se usan en el orden que se muestra anteriormente. Por lo tanto, si se especifica InterfaceLuid , este miembro se usa para determinar la interfaz. Si no se estableció ningún valor para el miembro InterfaceLuid (el valor de este miembro se estableció en cero), el miembro InterfaceIndex se usa a continuación para determinar la interfaz.

Si la función se realiza correctamente, se elimina la dirección IP existente que representa el parámetro Row .

El controlador puede llamar a la función GetUnicastIpAddressTable para enumerar las entradas de dirección IP de unidifusión en un equipo local. El controlador puede llamar a la función GetUnicastIpAddressEntry para recuperar una entrada de dirección IP de unidifusión existente específica.

Requisitos

Plataforma de destino

Universal

Versión

Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.

Encabezado

Netioapi.h (incluya Netioapi.h)

Biblioteca

Netio.lib

IRQL

< DISPATCH_LEVEL

Consulte también

CreateUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry