GetIfTable2, funkcja
Funkcja GetIfTable2 pobiera tabelę interfejsu MIB-II.
Składnia
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Parametry
-
tabeli [out]
Wskaźnik do buforu odbierającego tabelę interfejsów w strukturze MIB_IF_TABLE2.
Wartość zwracana
getIfTable2 zwraca STATUS_SUCCESS, jeśli funkcja zakończy się pomyślnie.
Jeśli funkcja nie powiedzie się, getIfTable2 zwraca jeden z następujących kodów błędów:
Kod powrotny | Opis |
---|---|
STATUS_NOT_ENOUGH_MEMORY | Za mało zasobów pamięci jest dostępnych do ukończenia operacji. |
inne | Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu. |
Uwagi
Funkcja GetIfTable2 wylicza interfejsy logiczne i fizyczne na komputerze lokalnym i zwraca te informacje w strukturze MIB_IF_TABLE2.
Sterownik może użyć podobnej funkcji, GetIfTable2Ex, aby określić poziom interfejsów do zwrócenia. Wywołanie funkcji GetIfTable2Ex z parametrem level ustawionym na MibIfTableNormal pobiera te same wyniki co wywołanie funkcji GetIfTable2.
GetIfTable2 zwraca interfejsy w strukturze MIB_IF_TABLE2 w buforze wskazującym parametr Table. Struktura MIB_IF_TABLE2 zawiera liczbę interfejsów i tablicę struktur MIB_IF_ROW2 dla każdego interfejsu. getIfTable2 przydziela pamięć dla struktury MIB_IF_TABLE2 i wpisów MIB_IF_ROW2 w tej strukturze. Gdy te zwrócone struktury nie są już wymagane, sterownik powinien zwolnić pamięć, wywołując FreeMibTable.
Należy pamiętać, że zwrócona struktura MIB_IF_TABLE2 wskazująca parametr tabeli może zawierać wypełnienie w celu wyrównania między elementem członkowskim NumEntries a pierwszym wpisem tablicy MIB_IF_ROW2 w tabeli składowej struktury MIB_IF_TABLE2. Dopełnienie do wyrównania może być również obecne między wpisami tablicy MIB_IF_ROW2. Każdy dostęp do wpisu tablicy MIB_IF_ROW2 powinien mieć założenie, że dopełnienie może istnieć.
Wymagania
Platforma docelowa |
universal |
Wersja |
Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows. |
Nagłówek |
Netioapi.h (include Netioapi.h) |
Biblioteka |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |