Udostępnij przez

SetIpNetEntry2, funkcja

Funkcja SetIpNetEntry2 ustawia fizyczny adres istniejącego wpisu adresu IP sąsiada na komputerze lokalnym.

Składnia

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Parametry

  • wiersza [in]
    Wskaźnik do wpisu struktury MIB_IPNET_ROW2 dla wpisu adresu IP sąsiada.

Wartość zwracana

setIpNetEntry2 zwrócić STATUS_SUCCESS, jeśli funkcja powiedzie się.

Jeśli funkcja nie powiedzie się, SetIpNetEntry2 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 w następujących sytuacjach.

  • Wskaźnik o wartości null został przekazany w parametrze wiersza.

  • Element Adres struktury MIB_IPNET_ROW2, do którego wskazuje parametr wiersza, nie został ustawiony na prawidłowy adres emisji pojedynczej, emisji ani multiemisji IPv4 lub IPv6.

  • Składowe PhysicalAddress i PhysicalAddressLength struktury MIB_IPNET_ROW2 nie zostały ustawione na prawidłowy adres fizyczny.

  • Obie InterfaceLuid i InterfaceIndex składowych struktury MIB_IPNET_ROW2 nie zostały określone.

  • Adres sprzężenia zwrotnego został przekazany w elemencie członkowskim adresu.
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

Sterownik musi zainicjować następujące elementy członkowskie struktury MIB_IPNET_ROW2, do których wskazuje parametr wiersza.

  • adres
    Ustaw na prawidłowy adres emisji pojedynczej, emisji dowolnej lub multiemisji IPv4 lub IPv6 i rodziny.

  • PhysicalAddress i PhysicalAddressLength
    Ustaw prawidłowy adres fizyczny.

  • 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.

Funkcja SetIpNetEntry2 kończy się niepowodzeniem, jeśli adres IP przekazany w adres elementu członkowskiego struktury MIB_IPNET_ROW2, do którego wskazuje parametr wiersza, nie jest istniejącym adresem IP sąsiada w określonym interfejsie.

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ż

CreateIpNetEntry2

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

getIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2

  • Last updated on