Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Funkcja GetIfEntry2 pobiera informacje dotyczące określonego interfejsu na komputerze lokalnym.
Ważny
W przypadku deweloperów sterowników zaleca się użycie GetIfEntry2Ex z identyfikatorem MibIfEntryNormalWithoutStatistics, aby uniknąć zakleszczenia podczas obsługi identyfikatorów OID NDIS.
Składnia
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Parametry
-
row [in, out]
Wskaźnik do struktury MIB_IF_ROW2, która po pomyślnym powrocie odbiera informacje o interfejsie na komputerze lokalnym. W danych wejściowych sterownik musi ustawić element członkowski InterfaceLuid lub InterfaceIndex składową struktury MIB_IF_ROW2 interfejsu w celu pobrania informacji.
Wartość zwracana
GetIfEntry2 zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.
Jeśli funkcja nie powiedzie się, getIfEntry2 zwraca jeden z następujących kodów błędów:
| Kod powrotny | Opis |
|---|---|
| STATUS_INVALID_PARAMETER | Do funkcji przekazano nieprawidłowy parametr. Ten błąd jest zwracany, jeśli wskaźnik o wartości null jest przekazywany w parametrze wiersza. |
| STATUS_NOT_FOUND | Nie można odnaleźć określonego interfejsu. Ten błąd jest zwracany, jeśli funkcja nie może odnaleźć interfejsu sieciowego określonego przez InterfaceLuid lub InterfaceIndex elementu członkowskiego struktury MIB_IF_ROW2, do której wskazuje parametr wiersza. |
| inne | Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu. |
Uwagi
W danych wejściowych sterownik musi zainicjować co najmniej InterfaceLuid lub element członkowski InterfaceIndex w strukturze MIB_IF_ROW2, która jest przekazywana w parametrze Row. Składowe są używane w kolejności wymienionej wcześniej. Dlatego jeśli określono InterfaceLuid, ten element członkowski jest używany do określania interfejsu. Jeśli nie ustawiono wartości elementu członkowskiego InterfaceLuid (wartość tego elementu członkowskiego została ustawiona na zero), element członkowski InterfaceIndex jest następnie używany do określania interfejsu.
W danych wyjściowych wypełniane są pozostałe pola struktury MIB_IF_ROW2, w których znajdują się punkty parametru wiersza.
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 |