Función SetIpNetEntry2
La función SetIpNetEntry2 establece la dirección física de una entrada de dirección IP vecina existente en un equipo local.
Sintaxis
NETIOAPI_API SetIpNetEntry2(
_In_ PMIB_IPNET_ROW2 Row
);
Parámetros
-
fila [in]
Puntero a una entrada de estructura de MIB_IPNET_ROW2 para una entrada de dirección IP vecina.
Valor devuelto
setIpNetEntry2 devolver STATUS_SUCCESS si la función se realiza correctamente.
Si se produce un error en la función, SetIpNetEntry2 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 en las situaciones siguientes.
|
| 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 InterfaceLuid o interfaceIndex miembro de la estructura de MIB_IPNET_ROW2 a la que apunta el parámetro fila. |
| STATUS_NOT_SUPPORTED | No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv4 ubicada en el equipo local y se especificó una dirección IPv4 en el miembro Address de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro Fila, o si no hay ninguna pila IPv6 ubicada en el equipo local y se especificó una dirección IPv6 en el miembro Dirección. |
| otros | Use la función FormatMessage para obtener la cadena del mensaje para el error devuelto. |
Observaciones
El controlador debe inicializar los siguientes miembros de la estructura MIB_IPNET_ROW2 a los que apunta el parámetro row .
dirección
Establézcalo en una familia y direcciones IPv4 o IPv6 válidas de unidifusión, difusión o multidifusión.physicalAddress y PhysicalAddressLength
Establézcalo en una dirección física 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.
Se produce un error en la función SetIpNetEntry2 si la dirección IP que se pasa en el miembro Address de la estructura MIB_IPNET_ROW2 a la que apunta el parámetro row no es una dirección IP vecina existente en la interfaz especificada.
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 |