Función GetIfTable2
La función GetIfTable2 recupera la tabla de interfaz MIB-II.
Sintaxis
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Parámetros
- Tabla [salida]
Puntero a un búfer que recibe la tabla de interfaces en una estructura de MIB_IF_TABLE2 .
Valor devuelto
GetIfTable2 devuelve STATUS_SUCCESS si la función se realiza correctamente.
Si se produce un error en la función, GetIfTable2 devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | Los recursos de memoria insuficientes están disponibles para completar la operación. |
| Otros | Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Observaciones
La función GetIfTable2 enumera las interfaces lógicas y físicas de un equipo local y devuelve esta información en una estructura de MIB_IF_TABLE2 .
El controlador puede usar una función similar, GetIfTable2Ex, para especificar el nivel de interfaces que se va a devolver. Una llamada a la función GetIfTable2Ex con el parámetro Level establecido en MibIfTableNormal recupera los mismos resultados que llamar a la función GetIfTable2 .
GetIfTable2 devuelve interfaces en una estructura de 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. 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, el controlador debe liberar la memoria llamando a FreeMibTable.
Tenga en cuenta que la estructura de MIB_IF_TABLE2 devuelta a la que apunta el parámetro Table podría 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 de MIB_IF_ROW2 debe suponer que puede existir relleno.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |