DeleteIpNetEntry2 függvény

A DeleteIpNetEntry2 függvény töröl egy szomszéd IP-címbejegyzést egy helyi számítógépen.

Szintaxis

NETIOAPI_API DeleteIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

Paraméterek

  • sor [in]
    Mutató egy szomszéd IP-címbejegyzés MIB_IPNET_ROW2 struktúrabejegyzésére. Sikeres visszatéréskor a bejegyzés törlődik.

Visszaadott érték

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

Ha a függvény meghiúsul, DeleteIpNetEntry2 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 DeleteIpNetEntry2 függvény egy MIB_IPNET_ROW2 struktúrabejegyzés törlé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.

Kimeneten a hívás sikerességének DeleteIpNetEntry2 törli a szomszéd IP-címet.

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:

CreateIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2

SetIpNetEntry2