GetIpNetEntry2 függvény

A GetIpNetEntry2 függvény a helyi számítógépen lévő szomszéd IP-cím bejegyzésének adatait kéri le.

Szintaxis

NETIOAPI_API GetIpNetEntry2(
  _Inout_ PMIB_IPNET_ROW2 Row
);

Paraméterek

• sor [be, ki]
  Mutató egy szomszéd IP-címbejegyzés MIB_IPNET_ROW2 struktúrabejegyzésére. Sikeres visszatérés esetén ez a struktúra frissül a szomszéd IP-cím tulajdonságaival.

Visszaadott érték

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

Ha a függvény meghiúsul, GetIpNetEntry2 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 akkor jelenik meg, ha egy NULL mutatót ad át a Sor paraméterben, az CímMIB_IPNET_ROW2 struktúra azon tagja, amely szerint a sor paraméter nem érvényes IPv4- vagy IPv6-címre volt beállítva, vagy InterfaceLuid és InterfaceIndex MIB_IPNET_ROW2-struktúra tagjai nem voltak meghatározva.
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

A GetIpNetEntry2 függvény egy MIB_IPNET_ROW2 struktúrabejegyzés lekérésére szolgál.

Bemenetkor az illesztőprogramnak inicializálnia kell annak a MIB_IPNET_ROW2 struktúrának a következő tagjait, amelyekre a Sor paraméter mutat.

• Cím
  Állítsa be egy érvényes szomszéd IPv4- vagy IPv6-címre és családra.

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

Ha a hívás sikeres, GetIpNetEntry2 lekéri a szomszéd IP-cím többi tulajdonságát, és kitölti azt a MIB_IPNET_ROW2 struktúrát, amelyre a sor paraméter mutat.

Az illesztőprogram meghívhatja a GetIpNetTable2 függvényt a helyi számítógépen található szomszédos IP-címbejegyzések számbavételéhez.

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:

GetIpNetTable2

MIB_IPNET_ROW2