Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De functie GetIpForwardEntry2 haalt informatie op voor een IP-routevermelding op een lokale computer.
Syntaxis
NETIOAPI_API GetIpForwardEntry2(
_Inout_ PMIB_IPFORWARD_ROW2 Row
);
Parameters
-
rij [in, uit]
Een aanwijzer naar een MIB_IPFORWARD_ROW2 structuurvermelding voor een IP-routevermelding. Bij geslaagde terugkeer wordt deze structuur bijgewerkt met de eigenschappen voor de IP-routevermelding.
Retourwaarde
GetIpForwardEntry2 retourneert STATUS_SUCCESS als de functie slaagt.
Als de functie mislukt, retourneert GetIpForwardEntry2 een van de volgende foutcodes:
| Retourcode | Beschrijving |
|---|---|
| STATUS_INVALID_PARAMETER | Er is een ongeldige parameter doorgegeven aan de functie. Deze fout wordt geretourneerd als een van de volgende situaties optreedt:
|
| STATUS_NOT_FOUND | Kan de opgegeven interface niet vinden. Deze fout wordt geretourneerd als de functie de netwerkinterface die is opgegeven door de InterfaceLuid- of InterfaceIndex lid van de MIB_IPFORWARD_ROW2 structuur waarnaar de parameter Rij verwijst, niet kan vinden. |
| STATUS_NOT_SUPPORTED | De aanvraag wordt niet ondersteund. Deze fout wordt geretourneerd als er geen IPv4-stack zich op de lokale computer bevindt en AF_INET is opgegeven in de adresfamilie in het DestinationPrefix lid van de MIB_IPFORWARD_ROW2-structuur waarnaar de parameter Row verwijst, of als er geen IPv6-stack zich op de lokale computer bevindt en AF_INET6 is opgegeven voor de adresfamilie in het DestinationPrefix lid. |
| Overige | Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen. |
Opmerkingen
De functie GetIpForwardEntry2 wordt gebruikt om een MIB_IPFORWARD_ROW2 structuurvermelding op te halen.
Bij invoer moet uw stuurprogramma de volgende leden van de MIB_IPFORWARD_ROW2-structuur initialiseren waarnaar de rij- parameter verwijst.
DestinationPrefix-
Ingesteld op een geldig IPv4- of IPv6-adresvoorvoegsel en -gezin.NextHop-
Ingesteld op een geldig IPv4- of IPv6-adres en -gezin.InterfaceLuid of InterfaceIndex
Deze leden worden gebruikt in de volgorde die eerder wordt vermeld. Dus als InterfaceLuid- is opgegeven, wordt dit lid gebruikt om de interface te bepalen. Als er geen waarde is ingesteld voor het InterfaceLuid lid (de waarde van dit lid is ingesteld op nul), wordt de InterfaceIndex lid naast het bepalen van de interface gebruikt.
Wanneer de aanroep is geslaagd, haalt GetIpForwardEntry2 de andere eigenschappen voor de IP-routevermelding op en vult u de MIB_IPFORWARD_ROW2 structuur in waarnaar de parameter rij parameter verwijst.
De offset voor metrische routegegevens die is opgegeven in het metrische lid van de MIB_IPFORWARD_ROW2-structuur die door de parameter rij wordt opgegeven, vertegenwoordigt slechts een deel van de volledige routemetriek. De volledige metrische waarde is een combinatie van deze routemetriek die is toegevoegd aan de metrische interfacegegevens die zijn opgegeven in de metrische lid van de MIB_IPINTERFACE_ROW structuur van de gekoppelde interface. Een stuurprogramma kan de metrische interface ophalen door de functie GetIpInterfaceEntry aan te roepen.
Uw stuurprogramma kan de GetIpForwardTable2- functie aanroepen om de IP-routevermeldingen op een lokale computer op te sommen.
Eisen
Doelplatform |
Universal |
Versie |
Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen. |
Rubriek |
Netioapi.h (inclusief Netioapi.h) |
Bibliotheek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |