Sdílet prostřednictvím


SetIpNetEntry2 – funkce

Funkce SetIpNetEntry2 nastaví fyzickou adresu položky ip adresy stávajícího souseda v místním počítači.

Syntax

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Parametry

  • řádek [in]
    Ukazatel na položku struktury MIB_IPNET_ROW2 pro položku IP adresy souseda.

Návratová hodnota

SetIpNetEntry2 vrátit STATUS_SUCCESS, pokud bude funkce úspěšná.

Pokud funkce selže, SetIpNetEntry2 vrátí jeden z následujících kódů chyb:

Návratový kód Popis
STATUS_INVALID_PARAMETER

Funkci byla předána neplatná hodnota parametru. Tato chyba se vrátí v následujících situacích.

  • V parametru řádku řádku byl předán ukazatel NULL.

  • Adresa člen struktury MIB_IPNET_ROW2, na kterou odkazuje parametr řádek, nebyl nastaven na platné jednosměrové vysílání, jakékoli vysílání nebo adresu IPv4 nebo IPv6 vícesměrového vysílání.

  • physicalAddress a PhysicalAddressLength členy struktury MIB_IPNET_ROW2 nebyly nastaveny na platnou fyzickou adresu.

  • InterfaceLuid i InterfaceIndex členy struktury MIB_IPNET_ROW2 nebyly zadány.

  • Adresa zpětné smyčky byla předána v Adresa člen.

STATUS_NOT_FOUND

Zadané rozhraní nebylo nalezeno. Tato chyba se vrátí, pokud funkce nemůže najít síťové rozhraní určené InterfaceLuid nebo InterfaceIndex člen struktury MIB_IPNET_ROW2, na kterou odkazuje řádek parametru.

STATUS_NOT_SUPPORTED

Požadavek není podporován. Tato chyba se vrátí, pokud v místním počítači není umístěn žádný zásobník IPv4 a adresa IPv4 byla zadána v Adresa člen struktury MIB_IPNET_ROW2, na kterou odkazuje parametr řádek parametr, nebo pokud se v místním počítači nenachází žádný zásobník IPv6 a adresa IPv6 byla zadána v adresa členu.

Jiné

Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu.

Poznámky

Ovladač musí inicializovat následující členy struktury MIB_IPNET_ROW2, na které odkazuje řádek parametru.

  • adresy
    Nastavte platnou jednosměrové vysílání, jakékoli vysílání nebo vícesměrové vysílání IPv4 nebo IPv6 adresu a rodinu.

  • physicalAddress a PhysicalAddressLength
    Nastavte na platnou fyzickou adresu.

  • InterfaceLuid nebo InterfaceIndex
    Tito členové se používají v pořadí, které je uvedeno dříve. Pokud je tedy zadán InterfaceLuid, použije se tento člen k určení rozhraní. Pokud nebyla nastavena žádná hodnota pro InterfaceLuid člen (hodnota tohoto členu byla nastavena na nulu), InterfaceIndex člen se použije k určení rozhraní.

Funkce SetIpNetEntry2 selže, pokud IP adresa předaná v adrese člen struktury MIB_IPNET_ROW2, na kterou parametr řádek odkazuje, není existující IP adresa souseda v zadaném rozhraní.

Požadavky

Cílová platforma

univerzální

Verze

K dispozici v systémech Windows Vista a novějších verzích operačních systémů Windows.

Záhlaví

Netioapi.h (včetně Netioapi.h)

Knihovna

Netio.lib

IRQL

< DISPATCH_LEVEL

Viz také

CreateIpNetEntry2

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2