Funktionen GetAnycastIpAddressEntry

Funktionen GetAnycastIpAddressEntry hämtar information om en befintlig anycast IP-adresspost på en lokal dator.

Syntax

NETIOAPI_API GetAnycastIpAddressEntry(
  _Inout_ PMIB_ANYCASTIPADDRESS_ROW Row
);

Parametrar

• Rad [in, ut]
  En pekare till en MIB_ANYCASTIPADDRESS_ROW strukturpost för en anycast IP-adresspost. Vid lyckad retur uppdateras den här strukturen med egenskaperna för en befintlig anycast IP-adress.

Returvärde

GetAnycastIpAddressEntry returnerar STATUS_SUCCESS om funktionen lyckas.

Om funktionen misslyckas returnerar GetAnycastIpAddressEntry någon av följande felkoder:

Returnera kod	Beskrivning
STATUS_INVALID_PARAMETER	En ogiltig parameter skickades till funktionen. Det här felet returneras om en NULL- pekare skickas i parametern Rad. -adressen medlem i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parametern pekar på inte har angetts till en giltig anycast IPv4- eller IPv6-adress, eller både InterfaceLuid och InterfaceIndex medlemmar i MIB_ANYCASTIPADDRESS_ROW-strukturen var ospecificerade.
STATUS_NOT_FOUND	Det gick inte att hitta det angivna gränssnittet. Det här felet returneras om funktionen inte kan hitta det nätverksgränssnitt som anges av InterfaceLuid eller InterfaceIndex medlem i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parameter pekar på.
STATUS_NOT_SUPPORTED	Begäran stöds inte. Det här felet returneras om ingen IPv4-stack finns på den lokala datorn och en IPv4-adress angavs i adress medlem i den MIB_UNICASTIPADDRESS_ROW struktur som Rad parameter pekar på, eller om ingen IPv6-stack finns på den lokala datorn och en IPv6-adress angavs i adress medlem.
Andra	Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet.

Anmärkningar

Funktionen GetAnycastIpAddressEntry används för att hämta en befintlig MIB_ANYCASTIPADDRESS_ROW strukturpost.

Vid indata måste drivrutinen initiera följande medlemmar i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parametern pekar på.

• adress
  Ange till en giltig IPv4- eller IPv6 anycast-adress och familj.

• InterfaceLuid eller InterfaceIndex
  Dessa medlemmar används i den ordning som anges tidigare. Så om InterfaceLuid anges används den här medlemmen för att fastställa gränssnittet. Om inget värde har angetts för InterfaceLuid medlem (värdet för den här medlemmen har angetts till noll) används InterfaceIndex medlem för att fastställa gränssnittet.

När anropet lyckas hämtar GetAnycastIpAddressEntry de andra egenskaperna för anycast-IP-adressen och fyller i den MIB_ANYCASTIPADDRESS_ROW struktur som rad parametern pekar på.

Drivrutinen kan anropa funktionen GetAnycastIpAddressTable för att räkna upp posterna för anycast-IP-adresser på en lokal dator.

Krav

Målplattform	Universell
Version	Finns i Windows Vista och senare versioner av Windows-operativsystemen.
Rubrik	Netioapi.h (inkludera Netioapi.h)
Bibliotek	Netio.lib
IRQL	< DISPATCH_LEVEL

Se även

CreateAnycastIpAddressEntry

DeleteAnycastIpAddressEntry

GetAnycastIpAddressTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE