Udostępnij za pośrednictwem


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

Zobacz też

FreeMibTable

GetIfTable2Ex

MIB_IF_TABLE2

MIB_IF_ROW2