DeleteAnycastIpAddressEntry függvény

A DeleteAnycastIpAddressEntry függvény töröl egy meglévő ip-címbejegyzést egy helyi számítógépen.

Szintaxis

NETIOAPI_API DeleteAnycastIpAddressEntry(
  _In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);

Paraméterek

  • sor [in]
    Mutató egy MIB_ANYCASTIPADDRESS_ROW struktúrabejegyzésre egy meglévő ip-címbejegyzéshez, amely törölhető a helyi számítógépről.

Visszaadott érték

DeleteAnycastIpAddressEntry STATUS_SUCCESS ad vissza, ha a függvény sikeres.

Ha a függvény meghiúsul, DeleteAnycastIpAddressEntry 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 NULL mutatót ad át a Sor paraméterben, az MIB_ANYCASTIPADDRESS_ROW struktúra Cím tagját, amely szerint a sor paraméterpontok nem voltak érvényes egycímes IPv4- vagy IPv6-címre állítva, vagy InterfaceLuid és InterfaceIndex MIB_ANYCASTIPADDRESS_ROW-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 által megadott hálózati adaptert, annak a MIB_ANYCASTIPADDRESS_ROW struktúrának a tagja, 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_ANYCASTIPADDRESS_ROW struktúrának azon tagja, 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 lett megadva a Cím tagban.

Egyéb

A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

A DeleteAnycastIpAddressEntry függvény egy meglévő MIB_ANYCASTIPADDRESS_ROW struktúrabejegyzés törlésére szolgál a helyi számítógépen.

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

  • Cím
    Állítsa be érvényes egycímes 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 függvény sikeres, a sor paraméter által megadott meglévő IP-cím törölve lett.

Az illesztőprogram meghívhatja a GetAnycastIpAddressTable függvényt, hogy számba tudja adni a helyi számítógépen a küldési IP-cím bejegyzéseit. Az illesztőprogram meghívhatja a GetAnycastIpAddressEntry függvényt egy adott meglévő ip-címbejegyzés lekérésé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:

CreateAnycastIpAddressEntry

GetAnycastIpAddressEntry

GetAnycastIpAddressTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE