Descripción general de IP Helper
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 IP Helper pasan parámetros de estructura que representan tipos de datos asociados a la Base de Información de Gestió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 ampliamente los términos adaptador e interfaz . Un adaptador es un término heredado que es una abreviatura de adaptador de red, que originalmente se refería a algún tipo de hardware de red. Un adaptador es una abstracción de nivel de enlace de datos.
Una interfaz se describe en los documentos RFC de IETF como un concepto abstracto que representa la conexión de un nodo a un enlace. Una interfaz es una abstracción de nivel IP.
Su controlador puede usar las siguientes funciones de modo núcleo, estructuras MIB y enumeraciones MIB y de nivel de red (NL) para recuperar y modificar las opciones de configuración para el transporte de 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 identificador 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 administración de interfaz
| Función | Descripción |
|---|---|
| GetIfEntry2 | Recupera información de la interfaz especificada en el equipo local. |
| GetIfStackTable | Recupera una tabla de entradas de filas de la pila de interfaces de red que especifica la relación de las interfaces de red en una pila de interfaces. |
| GetIfTable2 | Recupera la tabla de interfaz MIB-II. |
| GetIfTable2Ex | Recupera la tabla de interfaces MIB-II, dado un nivel de información de interfaz para recuperar. |
| GetInvertedIfStackTable | Recupera una tabla de entradas de filas de la pila de interfaces de red invertida que especifica la relación de las interfaces de red en una pila de interfaces. |
| 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 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 anycast 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 unicast en el equipo local. |
| DeleteAnycastIpAddressEntry | Elimina una entrada existente de dirección IP anycast del equipo local. |
| DeleteUnicastIpAddressEntry | Elimina una entrada de dirección IP unicast existente del equipo local. |
| GetAnycastIpAddressEntry | Recupera información de una entrada de dirección IP anycast existente en el equipo local. |
| GetAnycastIpAddressTable | Recupera la tabla de direcciones IP de anycast en el equipo local. |
| GetMulticastIpAddressEntry | Recupera la información de una entrada existente de dirección IP de multidifusión en el equipo local. |
| GetMulticastIpAddressTable | Recupera la tabla de direcciones IP de multidifusión del equipo local. |
| GetUnicastIpAddressEntry | Recupera información de una entrada de dirección IP unicast existente en el equipo local. |
| GetUnicastIpAddressTable | Recupera la tabla de direcciones IP de unidifusión del equipo local. |
| InitializeUnicastIpAddressEntry | Inicializa una estructura 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 de 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 de 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 IP vecina en el ordenador local. |
| SetIpNetEntry2 | Establece la dirección física de una entrada de dirección IP de un vecino existente en el equipo local. |
Funciones de administración de rutas de acceso IP
| Función | Descripción |
|---|---|
| FlushIpPathTable | Borra la tabla de rutas 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 tabla 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 sobre una entrada de ruta IP en el equipo local. |
| GetIpForwardTable2 | Recupera las entradas de ruta IP en el equipo local. |
| initializeIpForwardEntry | Inicializa una estructura MIB_IPFORWARD_ROW2 con valores predeterminados para una entrada de ruta IP en el ordenador local. |
| SetIpForwardEntry2 | Establece las propiedades de una entrada de ruta IP en el equipo local. |
Funciones de administración de memoria de tablas 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 de la interfaz IP, los cambios de dirección IP, los cambios de ruta IP y las solicitudes para recuperar la tabla de direcciones IP de unidifusión estable. |
| 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 cliente 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 ser notificado de los cambios en el número de puerto UDP que el cliente Teredo utiliza para el puerto de servicio Teredo en un equipo local. |
| NotifyStableUnicastIpAddressTable | Recupera la tabla de direcciones IP de unidifusión estable de un equipo local. |
Estructuras 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 anycast. |
| MIB_ANYCASTIPADDRESS_TABLE | Contiene una tabla de entradas de dirección IP de difusión por proximidad. |
| 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 interfaces de red. En esta tabla se especifica la relación de las interfaces de red en una pila de interfaces. |
| 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 interfaces de red invertida. 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 unicast. |
| 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. |
| TIPO_DE_NOTIFICACION_MIB | Define el tipo de notificación que se pasa a una función de devolución de llamada cuando ocurre 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. |