GetAnycastIpAddressEntry függvény

A GetAnycastIpAddressEntry függvény egy meglévő ip-címbejegyzés adatait kéri le egy helyi számítógépen.

Szintaxis

NETIOAPI_API GetAnycastIpAddressEntry(
  _Inout_ PMIB_ANYCASTIPADDRESS_ROW Row
);

Paraméterek

• sor [be, ki]
  Egy MIB_ANYCASTIPADDRESS_ROW struktúrabejegyzésre mutató mutató bármely ip-címbejegyzéshez. Sikeres visszatérés esetén ez a struktúra frissül egy meglévő ip-cím tulajdonságaival.

Visszaadott érték

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

Ha a függvény meghiúsul, GetAnycastIpAddressEntry 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_ANYCASTIPADDRESS_ROW struktúra azon tagja, amely szerint a Sor paraméter nem állított be érvényes IPv4- vagy IPv6-címre, 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 tagját, 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_UNICASTIPADDRESS_ROW 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 GetAnycastIpAddressEntry függvény egy meglévő MIB_ANYCASTIPADDRESS_ROW struktúrabejegyzés lekérésére szolgál.

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 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, GetAnycastIpAddressEntry lekéri a küldési IP-cím többi tulajdonságát, és kitölti azt a MIB_ANYCASTIPADDRESS_ROW struktúrát, amelyre a sor paraméter mutat.

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.

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

DeleteAnycastIpAddressEntry

GetAnycastIpAddressTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE