GetIpNetEntry2, funkcja

Funkcja GetIpNetEntry2 pobiera informacje dotyczące wpisu adresu IP sąsiada na komputerze lokalnym.

Składnia

NETIOAPI_API GetIpNetEntry2(
  _Inout_ PMIB_IPNET_ROW2 Row
);

Parametry

• row [in, out]
  Wskaźnik do wpisu struktury MIB_IPNET_ROW2 dla wpisu adresu IP sąsiada. Po pomyślnym powrocie ta struktura zostanie zaktualizowana o właściwości dla adresu IP sąsiada.

Wartość zwracana

getIpNetEntry2 zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.

Jeśli funkcja nie powiedzie się, getIpNetEntry2 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, Element Adres struktury MIB_IPNET_ROW2, do którego wskazuje parametr wiersza, nie został ustawiony na prawidłowy adres IPv4 lub IPv6 lub oba InterfaceLuid i InterfaceIndex składowych struktury MIB_IPNET_ROW2 nie zostały określone.
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_IPNET_ROW2 wskazuje parametr wiersza .
STATUS_NOT_SUPPORTED	Żądanie nie jest obsługiwane. Ten błąd jest zwracany, jeśli na komputerze lokalnym nie znajduje się stos IPv4, a adres IPv4 został określony w adres elementu członkowskiego MIB_IPNET_ROW2 struktury, do którego wskazuje wiersz lub jeśli na komputerze lokalnym nie znajduje się stos IPv6, a adres IPv6 został określony w elemencie Adres.
inne	Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu.

Uwagi

Funkcja GetIpNetEntry2 służy do pobierania wpisu struktury MIB_IPNET_ROW2.

W danych wejściowych sterownik musi zainicjować następujące elementy członkowskie struktury MIB_IPNET_ROW2, do których wskazuje parametr Row.

• adres
  Ustaw prawidłowy adres IPv4 lub adres IPv6 i rodzinę prawidłowych sąsiadów.

• InterfaceLuid lub InterfaceIndex
  Te elementy członkowskie 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.

Po pomyślnym wywołaniu GetIpNetEntry2 pobiera inne właściwości adresu IP sąsiada i wypełnia strukturę MIB_IPNET_ROW2 wskazującą parametr Row.

Sterownik może wywołać funkcję GetIpNetTable2 w celu wyliczenia wpisów adresu IP sąsiada na komputerze lokalnym.

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ż

getIpNetTable2

MIB_IPNET_ROW2