Función DeleteUnicastIpAddressEntry (netioapi.h)
La función DeleteUnicastIpAddressEntry elimina una entrada de dirección IP de unidifusión existente en el equipo local.
Sintaxis
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API DeleteUnicastIpAddressEntry(
[in] const MIB_UNICASTIPADDRESS_ROW *Row
);
Parámetros
[in] Row
Puntero a una entrada de estructura de MIB_UNICASTIPADDRESS_ROW para una entrada de dirección IP de unidifusión existente que se va a eliminar del equipo local.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
Acceso denegado. Este error se devuelve en varias condiciones que incluyen lo siguiente: el usuario carece de los privilegios administrativos necesarios en el equipo local o la aplicación no se ejecuta en un shell mejorado como administrador integrado (administrador de RunAs). |
|
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 del MIB_UNICASTIPADDRESS_ROW al 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 o InterfaceIndex del MIB_UNICASTIPADDRESS_ROW señalados por el parámetro Row no se especificaron. |
|
No se encontró la interfaz especificada. Este error se devuelve si no se encontró la interfaz de red especificada por el miembro InterfaceLuid o InterfaceIndex del MIB_UNICASTIPADDRESS_ROW al que apunta el parámetro Row . |
|
No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv4 en el equipo local y se especificó una dirección IPv4 en el miembro AddressMIB_UNICASTIPADDRESS_ROW apuntado por el parámetro Row . Este error también se devuelve si no hay ninguna pila IPv6 en el equipo local y se especificó una dirección IPv6 en el miembro Address . |
|
Use FormatMessage para obtener la cadena de mensaje del error devuelto. |
Comentarios
La función DeleteUnicastIpAddressEntry se define en Windows Vista y versiones posteriores.
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 miembro Address de la estructura MIB_UNICASTIPADDRESS_ROW a la que apunta el parámetro Row debe establecerse en una dirección y familia IPv4 de unidifusión válida o IPv6. Además, se debe inicializar al menos uno de los siguientes miembros de la estructura MIB_UNICASTIPADDRESS_ROW que apunta al parámetro Row : InterfaceLuid o InterfaceIndex.
Los campos se usan en el orden indicado 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 (los valores de este miembro se establecieron en cero), el miembro InterfaceIndex se usa a continuación para determinar la interfaz.
Si la función se realiza correctamente, se eliminó la dirección IP existente representada por el parámetro Row .
Se puede llamar a la función GetUnicastIpAddressTable para enumerar las entradas de dirección IP de unidifusión en un equipo local. Se puede llamar a la función GetUnicastIpAddressEntry para recuperar una entrada de dirección IP de unidifusión existente específica.
Un usuario que inició sesión como miembro del grupo Administradores solo puede llamar a la función DeleteUnicastIpAddressEntry . Si un usuario llama a DeleteUnicastIpAddressEntry que no es miembro del grupo Administradores, se producirá un error en la llamada a la función y se devolverá ERROR_ACCESS_DENIED . Esta función también puede producir un error debido al control de cuentas de usuario (UAC) en Windows Vista y versiones posteriores. Si un usuario inicia sesión como miembro del grupo Administradores que no sea el administrador integrado, esta llamada producirá un error a menos que la aplicación se haya marcado en el archivo de manifiesto con un valor requestedExecutionLevel establecido en requireAdministrator. Si la aplicación carece de este archivo de manifiesto, un usuario que inició sesión como miembro del grupo Administradores que no sea el administrador integrado debe ejecutar la aplicación en un shell mejorado como administrador integrado (administrador de RunAs) para que esta función se realice correctamente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | netioapi.h (incluya Iphlpapi.h) |
| Library | Iphlpapi.lib |
| Archivo DLL | Iphlpapi.dll |
Consulte también
Referencia de la función auxiliar de IP