Información general sobre el asistente de IP

Artículo
06/15/2023

El asistente de protocolo de Internet (asistente de IP) permite a los controladores recuperar información sobre la configuración de red del equipo local y modificar esa configuración. El asistente de IP también proporciona mecanismos de notificación para asegurarse de que se notifica a un controlador cuando cambian determinados aspectos de la configuración de red del equipo local. El asistente de IP está disponible en Windows Vista y versiones posteriores de los sistemas operativos Microsoft Windows.

Muchas de las funciones auxiliares de IP pasan parámetros de estructura que representan tipos de datos asociados a la tecnología base de información de administración (MIB). Las funciones auxiliares de IP usan estas estructuras MIB para representar varias informaciones de red.

La documentación del asistente de IP usa los términos "adapter" y "interface" ampliamente. Un adaptador es un término heredado que es una forma abreviada del adaptador de red, que originalmente se refiere a alguna forma de hardware de red. Un adaptador es una abstracción de nivel de vínculo de datos.

Una interfaz se describe en los documentos RFC de IETF como un concepto abstracto que representa los datos adjuntos de un nodo a un vínculo. Una interfaz es una abstracción de nivel IP.

El controlador puede usar las siguientes funciones en modo kernel, estructuras MIB y enumeraciones miB y capa de red (NL) para recuperar y modificar las opciones de configuración para el transporte del protocolo de control de transmisión/protocolo de Internet (TCP/IP) en un equipo local.

Nota:

Al desarrollar código de controlador, siga las instrucciones para incluir archivos de encabezado.

Funciones de conversión de interfaz

Función	Descripción
ConvertInterfaceAliasToLuid	Convierte un identificador único local (LUID) para una interfaz de red en el nombre de la interfaz Unicode.
ConvertInterfaceGuidToLuid	Convierte un identificador único global (GUID) para una interfaz de red en el LUID de la interfaz.
ConvertInterfaceIndexToLuid	Convierte un índice local para una interfaz de red en el LUID de la interfaz.
ConvertInterfaceLuidToAlias	Convierte un LUID para una interfaz de red en un alias de interfaz.
ConvertInterfaceLuidToGuid	Convierte un LUID para una interfaz de red en un GUID para la interfaz.
ConvertInterfaceLuidToIndex	Convierte un LUID para una interfaz de red en el índice local de la interfaz.
ConvertInterfaceLuidToNameA	Convierte un LUID para una interfaz de red en el nombre de la interfaz ANSI.
ConvertInterfaceLuidToNameW	Convierte un LUID para una interfaz de red en el nombre de la interfaz Unicode.
ConvertInterfaceNameToLuidA	Convierte un nombre de interfaz de red ANSI en el LUID de la interfaz.
ConvertInterfaceNameToLuidW	Convierte un nombre de interfaz de red Unicode en el LUID de la interfaz.
if_indextoname	Convierte el índice local de una interfaz de red en el nombre de la interfaz ANSI.
if_nametoindex	Convierte el nombre de la interfaz ANSI para una interfaz de red en el índice local de la interfaz.

Funciones de gestión de interfaces

Función	Descripción
GetIfEntry2	Recupera información de la interfaz especificada en el equipo local.
GetIfStackTable	Recupera una tabla de entradas de fila de pila de interfaz de red que especifican la relación de las interfaces de red en una pila de interfaz.
GetIfTable2	Recupera la tabla de interfaz MIB-II.
GetIfTable2Ex	Recupera la tabla de interfaz MIB-II, dada un nivel de información de interfaz que se va a recuperar.
GetInvertedIfStackTable	Recupera una tabla de entradas de fila de pila de interfaz de red invertidos que especifican la relación de las interfaces de red en una pila de interfaz.
GetIpInterfaceEntry	Recupera información de IP para la interfaz especificada en el equipo local.
GetIpInterfaceTable	Recupera las entradas de la interfaz IP en el equipo local.
InitializeIpInterfaceEntry	Inicializa los miembros de una entrada de estructura de MIB_IPINTERFACE_ROW con valores predeterminados.
SetIpInterfaceEntry	Establece las propiedades de una interfaz IP en el equipo local.

Funciones de administración de direcciones IP

Función	Descripción
CreateAnycastIpAddressEntry	Agrega una nueva entrada de dirección IP de difusión en el equipo local.
CreateSortedAddressPairs	Empareja una lista proporcionada de direcciones de destino junto con las direcciones IP locales del equipo host y ordena los pares según el orden preferido de comunicación.
CreateUnicastIpAddressEntry	Agrega una nueva entrada de dirección IP de unidifusión en el equipo local.
DeleteAnycastIpAddressEntry	Elimina una entrada de dirección IP de difusión existente en el equipo local.
DeleteUnicastIpAddressEntry	Elimina una entrada de dirección IP de unidifusión existente del equipo local.
GetAnycastIpAddressEntry	Recupera información de una entrada de dirección IP de difusión existente en el equipo local.
GetAnycastIpAddressTable	Recupera la tabla de direcciones IP de difusión en el equipo local.
GetMulticastIpAddressEntry	Recupera información de una entrada de dirección IP de multidifusión existente en el equipo local.
GetMulticastIpAddressTable	Recupera la tabla de direcciones IP de multidifusión en el equipo local.
GetUnicastIpAddressEntry	Recupera información de una entrada de dirección IP de unidifusión existente en el equipo local.
GetUnicastIpAddressTable	Recupera la tabla de direcciones IP de unidifusión en el equipo local.
InitializeUnicastIpAddressEntry	Inicializa una estructura de MIB_UNICASTIPADDRESS_ROW con valores predeterminados para una entrada de dirección IP de unidifusión en el equipo local.
NotifyStableUnicastIpAddressTable	Recupera la tabla de direcciones IP de unidifusión estable en un equipo local.
SetUnicastIpAddressEntry	Establece las propiedades de una entrada de dirección IP de unidifusión existente en el equipo local.

Funciones de administración de direcciones vecinas IP

Función	Descripción
CreateIpNetEntry2	Crea una nueva entrada de dirección IP vecina en el equipo local.
DeleteIpNetEntry2	Elimina una entrada de dirección IP vecina del equipo local.
FlushIpNetTable2	Vacía la tabla de vecinos ip en el equipo local.
GetIpNetEntry2	Recupera información de una entrada de dirección IP vecina en el equipo local.
GetIpNetTable2	Recupera la tabla de vecinos IP en el equipo local.
ResolveIpNetEntry2	Resuelve la dirección física de una entrada de dirección IP vecina en el equipo local.
SetIpNetEntry2	Establece la dirección física de una entrada de dirección IP de vecino existente en el equipo local.

Funciones de administración de rutas de IP

Función	Descripción
FlushIpPathTable	Vacía la tabla de ruta de acceso IP en el equipo local.
GetIpPathEntry	Recupera información de una entrada de ruta de acceso IP en el equipo local.
GetIpPathTable	Recupera información de una entrada de ruta de acceso IP en el equipo local.

Funciones de administración de rutas IP

Función	Descripción
CreateIpForwardEntry2	Crea una nueva entrada de ruta IP en el equipo local.
DeleteIpForwardEntry2	Elimina una entrada de ruta IP del equipo local.
GetBestRoute2	Recupera la entrada de ruta IP en el equipo local para obtener la mejor ruta a la dirección IP de destino especificada.
GetIpForwardEntry2	Recupera información de una entrada de ruta IP en el equipo local.
GetIpForwardTable2	Recupera las entradas de ruta IP en el equipo local.
InitializeIpForwardEntry	Inicializa una estructura de MIB_IPFORWARD_ROW2 con valores predeterminados para una entrada de ruta IP en el equipo local.
SetIpForwardEntry2	Establece las propiedades de una entrada de ruta IP en el equipo local.

Funciones de administración de memoria de tablas de IP

Función	Descripción
FreeMibTable	Libera el búfer asignado por las funciones que devuelven tablas de interfaces de red, direcciones y rutas (por ejemplo, GetIfTable2 y GetAnycastIpAddressTable).

Funciones de notificación

Función	Descripción
CancelMibChangeNotify2	Anula el registro del controlador para las notificaciones de cambio para los cambios de la interfaz IP, los cambios de dirección IP, los cambios de ruta IP y las solicitudes para recuperar la tabla estable de direcciones IP de unidifusión.
NotifyIpInterfaceChange	Registra el controlador para recibir notificaciones de cambios en todas las interfaces IP, interfaces IPv4 o interfaces IPv6 en un equipo local.
NotifyRouteChange2	Se registra para recibir una notificación de los cambios en las entradas de ruta IP en un equipo local.
NotifyUnicastIpAddressChange	Se registra para recibir notificaciones de cambios en todas las interfaces IP de unidifusión, direcciones IPv4 de unidifusión o direcciones IPv6 de unidifusión en un equipo local.

Funciones de administración de clientes IPv6 de Teredo

Función	Descripción
GetTeredoPort	Recupera el número de puerto UDP dinámico que usa el cliente teredo en el equipo local.
NotifyTeredoPortChange	Se registra para recibir una notificación de los cambios en el número de puerto UDP que el cliente teredo usa para el puerto de servicio teredo en un equipo local.
NotifyStableUnicastIpAddressTable	Recupera la tabla de direcciones IP de unidifusión estable en un equipo local.

Estructuras de MIB

Estructura	Descripción
IP_ADDRESS_PREFIX	Almacena un prefijo de dirección IP.
MIB_ANYCASTIPADDRESS_ROW	Almacena información sobre una dirección IP de difusión.
MIB_ANYCASTIPADDRESS_TABLE	Contiene una tabla de entradas de dirección IP de difusión.
MIB_IF_ROW2	Almacena información sobre una interfaz determinada.
MIB_IF_TABLE2	Contiene una tabla de entradas de interfaz lógica y física.
MIB_IFSTACK_ROW	Representa la relación entre dos interfaces de red.
MIB_IFSTACK_TABLE	Contiene una tabla de entradas de fila en la pila de interfaz de red. En esta tabla se especifica la relación de las interfaces de red en una pila de interfaz.
MIB_INVERTEDIFSTACK_ROW	Representa la relación entre dos interfaces de red.
MIB_INVERTEDIFSTACK_TABLE	Contiene una tabla de entradas de fila de la pila de interfaz de red invertidos. En esta tabla se especifica la relación de las interfaces de red en una pila de interfaz en orden inverso.
MIB_IPFORWARD_ROW2	Almacena información sobre una entrada de ruta IP.
MIB_IPFORWARD_TABLE2	Contiene una tabla de entradas de ruta IP.
MIB_IPINTERFACE_ROW	Almacena información de administración de interfaz para una familia de direcciones IP determinada en una interfaz de red.
MIB_IPINTERFACE_TABLE	Contiene una tabla de entradas de interfaz IP.
MIB_IPNET_ROW2	Almacena información sobre una dirección IP vecina.
MIB_IPNET_TABLE2	Contiene una tabla de entradas de direcciones IP vecinas.
MIB_IPPATH_ROW	Almacena información sobre una entrada de ruta de acceso IP.
MIB_IPPATH_TABLE	Contiene una tabla de entradas de ruta de acceso IP.
MIB_MULTICASTIPADDRESS_ROW	Almacena información sobre una dirección IP de multidifusión.
MIB_MULTICASTIPADDRESS_TABLE	Contiene una tabla de entradas de dirección IP de multidifusión.
MIB_UNICASTIPADDRESS_ROW	Almacena información sobre una dirección IP de unidifusión.
MIB_UNICASTIPADDRESS_TABLE	Contiene una tabla de entradas de dirección IP de unidifusión.

Enumeraciones de MIB

Enumeración	Descripción
MIB_IF_TABLE_LEVEL	Define el nivel de información de interfaz que se va a recuperar.
MIB_NOTIFICATION_TYPE	Define el tipo de notificación que se pasa a una función de devolución de llamada cuando se produce una notificación.

Enumeraciones NL

Enumeración	Descripción
NL_ADDRESS_TYPE	Especifica el tipo de dirección IP de la capa de red.
NL_DAD_STATE	Define el estado de detección de direcciones duplicadas (DAD).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR	Define el comportamiento de la dirección local del vínculo.
NL_NEIGHBOR_STATE	Define el estado de una dirección IP vecina de capa de red, como se describe en RFC 2461, sección 7.3.2.
NL_PREFIX_ORIGIN	Define el origen del prefijo o la parte de red de la dirección IP.
NL_ROUTE_ORIGIN	Define el origen de la ruta IP.
NL_ROUTE_PROTOCOL	Define el mecanismo de enrutamiento con el que se agregó una ruta IP, como se describe en RFC 4292.
NL_ROUTER_DISCOVERY_BEHAVIOR	Define el comportamiento de detección del enrutador, como se describe en RFC 2461.
NL_SUFFIX_ORIGIN	Define el origen del sufijo o la parte host de la dirección IP.

Compartir a través de