Función GetIfTable2 (netioapi.h)
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 |
|---|---|
|
Hay recursos de memoria insuficientes disponibles para completar la operación. |
|
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 |