SetIpNetEntry2 függvény

A SetIpNetEntry2 függvény beállítja egy meglévő szomszéd IP-cím bejegyzés fizikai címét egy helyi számítógépen.

Szintaxis

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Paraméterek

• sor [in]
  Mutató egy szomszéd IP-címbejegyzés MIB_IPNET_ROW2 struktúrabejegyzésére.

Visszaadott érték

SetIpNetEntry2 a függvény sikeres működése esetén STATUS_SUCCESS ad vissza.

Ha a függvény meghiúsul, SetIpNetEntry2 a következő hibakódok egyikét adja vissza:

Kód visszaadása	Leírás
STATUS_INVALID_PARAMETER	Érvénytelen paraméter lett átadva a függvénynek. Ez a hiba a következő helyzetekben jelenik meg. A Sor paraméterben egy NULL mutató lett átadva. A Cím azon MIB_IPNET_ROW2 struktúra azon tagja, amely szerint a Sor paraméter nem érvényes unicast, anycast vagy csoportos IPv4- vagy IPv6-címre volt beállítva. A MIB_IPNET_ROW2 struktúra PhysicalAddress és PhysicalAddressLength tagjai nem voltak érvényes fizikai címre állítva. InterfaceLuid és InterfaceIndex MIB_IPNET_ROW2 struktúrájának tagjai nem voltak meghatározva. A visszacsatolási cím a Cím tagban lett átadva.
STATUS_NOT_FOUND	A megadott felület nem található. Ez a hiba akkor jelenik meg, ha a függvény nem találja a InterfaceLuid vagy InterfaceIndex MIB_IPNET_ROW2 struktúra azon tagja által megadott hálózati adaptert, amelyre a Sor paraméter mutat.
STATUS_NOT_SUPPORTED	A kérés nem támogatott. Ez a hiba akkor jelenik meg, ha nem található IPv4-verem a helyi számítógépen, és egy IPv4-cím van megadva a Cím azon MIB_IPNET_ROW2 struktúrában, amelyre a Sor paraméter mutat, vagy ha nem található IPv6-verem a helyi számítógépen, és egy IPv6-cím van megadva a Cím tagban.
Egyéb	A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

Az illesztőprogramnak inicializálnia kell a MIB_IPNET_ROW2 struktúra alábbi tagjait, amelyekre a sor paraméter mutat.

• Cím
  Állítsa be érvényes egycímes, bármely küldési vagy csoportos IPv4- vagy IPv6-címre és -családra.

• PhysicalAddress és PhysicalAddressLength
  Állítson be érvényes fizikai címet.

• InterfaceLuid vagy InterfaceIndex
  Ezeket a tagokat a korábban felsorolt sorrendben használja a rendszer. Ha tehát InterfaceLuid van megadva, ez a tag határozza meg a felületet. Ha a InterfaceLuid taghoz nem állított be értéket (ennek a tagnak az értéke nulla volt), a InterfaceIndex tagot használja a rendszer a felület meghatározásához.

A SetIpNetEntry2 függvény meghiúsul, ha a Cím azon MIB_IPNET_ROW2 struktúrában átadott IP-cím, amelyre a sor paraméter mutat, nem egy meglévő szomszéd IP-cím a megadott felületen.

Követelmények

Célplatform	Univerzális
Verzió	Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban.
Fejléc	Netioapi.h (netioapi.h)
Könyvtár	Netio.lib
IRQL	< DISPATCH_LEVEL

Lásd még:

CreateIpNetEntry2

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2