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.
Met de functie GetIpInterfaceEntry worden IP-gegevens opgehaald voor de opgegeven interface op een lokale computer.
Syntaxis
NETIOAPI_API GetIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
Parameters
-
rij [in, uit]
Een aanwijzer naar een MIB_IPINTERFACE_ROW structuur die, bij geslaagde terugkeer, informatie ontvangt voor een interface op de lokale computer. Bij invoer moet uw stuurprogramma het InterfaceLuid- lid of het InterfaceIndex lid van de MIB_IPINTERFACE_ROW instellen op de interface om informatie voor op te halen.
Retourwaarde
GetIpInterfaceEntry- retourneert STATUS_SUCCESS als de functie slaagt.
Als de functie mislukt, retourneert GetIpInterfaceEntry 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 NULL- aanwijzer wordt doorgegeven in de parameter rij, het Family lid van de MIB_IPINTERFACE_ROW-structuur waarnaar de parameter van rij verwijst, niet is opgegeven als AF_INET of AF_INET6, of de InterfaceLuid- en InterfaceIndex leden van de MIB_IPINTERFACE_ROW-structuur zijn niet opgegeven. |
| 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 niet kan vinden lid van de MIB_IPINTERFACE_ROW-structuur waarnaar de parameter Rij parameter verwijst. |
| Overige | Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen. |
Opmerkingen
Bij invoer moet uw stuurprogramma de volgende leden van de MIB_IPINTERFACE_ROW-structuur initialiseren waarnaar de parameter rij verwijst.
Family-
Ingesteld op AF_INET of AF_INET6.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.
In de uitvoer vult GetIpInterfaceEntry de resterende leden van de MIB_IPINTERFACE_ROW-structuur in waarnaar de parameter Row verwijst.
Uw stuurprogramma moet de functie InitializeIpInterfaceEntry gebruiken om de velden van een MIB_IPINTERFACE_ROW structuurvermelding met standaardwaarden te initialiseren. Een stuurprogramma kan vervolgens de velden in de MIB_IPINTERFACE_ROW vermelding wijzigen die het wil wijzigen en vervolgens de SetIpInterfaceEntry functie aanroepen.
Niet-gemachtigde gelijktijdige toegang tot meerdere netwerken met verschillende beveiligingsvereisten creëert een beveiligingsgat en stelt een onbevoegd stuurprogramma in staat per ongeluk gegevens door te sturen tussen de twee netwerken. Een typisch voorbeeld is gelijktijdige toegang tot een virtueel particulier netwerk (VPN) en internet. De besturingssystemen Windows Server 2003 en Windows XP gebruiken een zwak hostmodel, waarbij RAS (Remote Access Service) dergelijke gelijktijdige toegang voorkomt door de metrische routegegevens van alle standaardroutes via andere interfaces te verhogen. Daarom wordt al het verkeer gerouteerd via de VPN-interface, waardoor andere netwerkconnectiviteit wordt onderbroken.
Op Windows Vista en latere versies van de Windows-besturingssystemen wordt standaard een sterk hostmodel gebruikt. Als een bron-IP-adres is opgegeven in de routezoekactie met behulp van de functie GetBestRoute2, wordt de routezoekfunctie beperkt tot de interface van het bron-IP-adres. De wijziging van de metrische routegegevens door RAS heeft geen effect omdat de lijst met mogelijke routes niet eens de route voor de VPN-interface heeft, waardoor verkeer naar internet mogelijk is. Uw stuurprogramma kan de DisableDefaultRoutes lid van de MIB_IPINTERFACE_ROW gebruiken om het gebruik van de standaardroute op een interface uit te schakelen. VPN-clients kunnen dit lid gebruiken als een beveiligingsmaatregel om split tunneling te beperken wanneer split tunneling niet vereist is voor de VPN-client. Een VPN-client kan de functie SetIpInterfaceEntry- aanroepen om het DisableDefaultRoutes-lid in te stellen op TRUE- wanneer dit nodig is. Een VPN-client kan de huidige status van de DisableDefaultRoutes lid opvragen door de functie GetIpInterfaceEntry- aan te roepen.
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 |