Funktionen GetIfTable2
Funktionen GetIfTable2 hämtar MIB-II-gränssnittstabellen.
Syntax
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Parametrar
-
Table [out]
En pekare till en buffert som tar emot tabellen med gränssnitt i en MIB_IF_TABLE2 struktur.
Returvärde
GetIfTable2 returnerar STATUS_SUCCESS om funktionen lyckas.
Om funktionen misslyckas returnerar GetIfTable2 någon av följande felkoder:
| Returnera kod | Beskrivning |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | Det finns inte tillräckligt med minnesresurser för att slutföra åtgärden. |
| Andra | Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet. |
Anmärkningar
Funktionen GetIfTable2 räknar upp de logiska och fysiska gränssnitten på en lokal dator och returnerar den här informationen i en MIB_IF_TABLE2 struktur.
Drivrutinen kan använda en liknande funktion, GetIfTable2Ex, för att ange vilken nivå av gränssnitt som ska returneras. Ett anrop till funktionen GetIfTable2Ex med parametern Level inställd på MibIfTableNormal hämtar samma resultat som att anropa funktionen GetIfTable2.
GetIfTable2 returnerar gränssnitt i en MIB_IF_TABLE2 struktur i bufferten som Table parametern pekar på. Den MIB_IF_TABLE2 strukturen innehåller ett antal gränssnitt och en matris med MIB_IF_ROW2 strukturer för varje gränssnitt. GetIfTable2 allokerar minne för MIB_IF_TABLE2 struktur och MIB_IF_ROW2 poster i den här strukturen. När dessa returnerade strukturer inte längre krävs bör drivrutinen frigöra minnet genom att anropa FreeMibTable.
Observera att den returnerade MIB_IF_TABLE2 struktur som table parameter pekar på kan innehålla utfyllnad för justering mellan NumEntries-medlemmen och den första MIB_IF_ROW2 matrisposten i Table medlem i MIB_IF_TABLE2-strukturen. Utfyllnad för justering kan också finnas mellan MIB_IF_ROW2 matrisposter. All åtkomst till en MIB_IF_ROW2 matrispost bör förutsätta att utfyllnad kan finnas.
Krav
Målplattform |
Universell |
Version |
Finns i Windows Vista och senare versioner av Windows-operativsystemen. |
Rubrik |
Netioapi.h (inkludera Netioapi.h) |
Bibliotek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |