Función GetIfTable2 (netioapi.h)

Artículo
02/29/2024

La función GetIfTable2 recupera la tabla de interfaz MIB-II.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfTable2(
  [out] PMIB_IF_TABLE2 *Table
);

Parámetros

[out] Table

Puntero a un búfer que recibe la tabla de interfaces en una estructura de MIB_IF_TABLE2 .

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
ERROR_NOT_ENOUGH_MEMORY	Hay recursos de memoria insuficientes disponibles para completar la operación.
Otros	Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

The
La función GetIfTable2 enumera las interfaces lógicas y físicas de un sistema local y devuelve esta información en una estructura de MIB_IF_TABLE2 . GetIfTable2 es una versión mejorada de la función GetIfTable .

Se puede usar una función GetIfTable2Ex similar para especificar el nivel de interfaces que se va a devolver. Llamar a la función GetIfTable2Ex con el parámetro Level establecido en MibIfTableNormal recupera los mismos resultados que llamar a la función GetIfTable2 .

Las interfaces se devuelven en una estructura MIB_IF_TABLE2 en el búfer al que apunta el parámetro Table . La estructura MIB_IF_TABLE2 contiene un recuento de interfaces y una matriz de estructuras de MIB_IF_ROW2 para cada interfaz. La función GetIfTable2 asigna memoria para la estructura MIB_IF_TABLE2 y las entradas MIB_IF_ROW2 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_IF_TABLE2 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_IF_ROW2 en el miembro Table de la estructura MIB_IF_TABLE2 . El relleno para la alineación también puede estar presente entre las entradas de matriz de MIB_IF_ROW2 . Cualquier acceso a una entrada de matriz MIB_IF_ROW2 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