Función GetIfStackTable (netioapi.h)
La función 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.
Sintaxis
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfStackTable(
[out] PMIB_IFSTACK_TABLE *Table
);
Parámetros
[out] Table
Puntero a un búfer que recibe la tabla de entradas de fila de pila de interfaz en una estructura de MIB_IFSTACK_TABLE .
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 |
|---|---|
|
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 . |
|
Hay recursos de memoria insuficientes disponibles para completar la operación. |
|
No se encontraron entradas de pila de interfaz. |
|
Use la función FormatMessage para obtener la cadena de mensaje del error devuelto. |
Comentarios
La función GetIfStackTable se define en Windows Vista y versiones posteriores.
The
La función GetIfStackTable enumera las interfaces de red físicas y lógicas en una pila de interfaz de un sistema local y devuelve esta información en una estructura de MIB_IFSTACK_TABLE .
Las entradas de la pila de interfaz se devuelven en una estructura de MIB_IFSTACK_TABLE en el búfer al que apunta el parámetro Table . La estructura MIB_IFSTACK_TABLE contiene un recuento de entradas de pila de interfaz y una matriz de estructuras de MIB_IFSTACK_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_IFSTACK_ROW está inmediatamente por encima de la interfaz con índice en el miembro LowerLayerInterfaceIndex de la estructura MIB_IFSTACK_ROW .
La función GetIfStackTable asigna memoria para la estructura MIB_IFSTACK_TABLE y las entradas de MIB_IFSTACK_ROW 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_IFSTACK_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_IFSTACK_ROW en el miembro Table de la estructura MIB_IFSTACK_TABLE . El relleno para la alineación también puede estar presente entre las entradas de matriz de MIB_IFSTACK_ROW . Cualquier acceso a una entrada de matriz de MIB_IFSTACK_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 (incluya Iphlpapi.h) |
| Library | Iphlpapi.lib |
| Archivo DLL | Iphlpapi.dll |