Compartir a través de


Función GetInvertedIfStackTable (netioapi.h)

La función GetInvertedIfStackTable recupera una tabla de entradas de fila de la pila de interfaz de red invertidos que especifican la relación de las interfaces de red en una pila de interfaz.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetInvertedIfStackTable(
  [out] PMIB_INVERTEDIFSTACK_TABLE *Table
);

Parámetros

[out] Table

Puntero a un búfer que recibe la tabla de entradas de fila de la pila de interfaz invertidos en una estructura de MIB_INVERTEDIFSTACK_TABLE .

Valor devuelto

Si la función se ejecuta 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
ERROR_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 Table .
ERROR_NOT_ENOUGH_MEMORY
Los recursos de memoria insuficientes están disponibles para completar la operación.
ERROR_NOT_FOUND
No se encontraron entradas de pila de interfaz.
Otros
Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función GetInvertedIfStackTable se define en Windows Vista y versiones posteriores.

The
La función GetInvertedIfStackTable enumera las interfaces de red físicas y lógicas de una pila de interfaz en un sistema local y devuelve esta información en un formulario invertido en la estructura MIB_INVERTEDIFSTACK_TABLE .

Las entradas de la pila de interfaz se devuelven en una estructura de MIB_INVERTEDIFSTACK_TABLE en el búfer al que apunta el parámetro Table . La estructura MIB_INVERTEDIFSTACK_TABLE contiene un recuento de entradas de pila de interfaz y una matriz de estructuras de MIB_INVERTEDIFSTACK_ROW para cada entrada de pila de interfaz.

La relación entre las interfaces de la pila de interfaz es que la interfaz con índice en el miembro HigherLayerInterfaceIndex de la estructura MIB_INVERTEDIFSTACK_ROW está inmediatamente por encima de la interfaz con el índice en el miembro LowerLayerInterfaceIndex de la estructura MIB_INVERTEDIFSTACK_ROW .

La función GetInvertedIfStackTable asigna memoria para la estructura MIB_INVERTEDIFSTACK_TABLE y las MIB_INVERTEDIFSTACK_ROW entradas de esta estructura. Cuando estas estructuras devueltas ya no son necesarias, libere la memoria llamando a FreeMibTable.

Tenga en cuenta que la estructura de MIB_INVERTEDIFSTACK_TABLE devuelta a la que apunta el parámetro Table puede contener relleno para la alineación entre el miembro NumEntries y la primera entrada de matriz MIB_INVERTEDIFSTACK_ROW en el miembro Table de la estructura MIB_INVERTEDIFSTACK_TABLE . El relleno para la alineación también puede estar presente entre las entradas de matriz de MIB_INVERTEDIFSTACK_ROW . Cualquier acceso a una entrada de matriz de MIB_INVERTEDIFSTACK_ROW debe suponer que puede existir relleno.

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 (include Iphlpapi.h)
Library Iphlpapi.lib
Archivo DLL Iphlpapi.dll

Consulte también

FreeMibTable

GetIfEntry2

GetIfStackTable

GetIfTable2

GetIpInterfaceEntry

InitializeIpInterfaceEntry

MIB_IFSTACK_ROW

MIB_IFSTACK_TABLE

MIB_IF_ROW2

MIB_IF_TABLE2

MIB_INVERTEDIFSTACK_ROW

MIB_INVERTEDIFSTACK_TABLE

MIB_IPINTERFACE_ROW

NotifyIpInterfaceChange

SetIpInterfaceEntry