MIB_IPINTERFACE_ROW structuur

Artikel
2025-03-13

De MIB_IPINTERFACE_ROW structuur slaat interfacebeheergegevens op voor een bepaalde IP-adresfamilie op een netwerkinterface.

Syntaxis

typedef struct _MIB_IPINTERFACE_ROW {
  ADDRESS_FAMILY                 Family;
  NET_LUID                       InterfaceLuid;
  NET_IFINDEX                    InterfaceIndex;
  ULONG                          MaxReassemblySize;
  ULONG64                        InterfaceIdentifier;
  ULONG                          MinRouterAdvertisementInterval;
  ULONG                          MaxRouterAdvertisementInterval;
  BOOLEAN                        AdvertisingEnabled;
  BOOLEAN                        ForwardingEnabled;
  BOOLEAN                        WeakHostSend;
  BOOLEAN                        WeakHostReceive;
  BOOLEAN                        UseAutomaticMetric;
  BOOLEAN                        UseNeighborUnreachabilityDetection;
  BOOLEAN                        ManagedAddressConfigurationSupported;
  BOOLEAN                        OtherStatefulConfigurationSupported;
  BOOLEAN                        AdvertiseDefaultRoute;
  NL_ROUTER_DISCOVERY_BEHAVIOR   RouterDiscoveryBehavior;
  ULONG                          DadTransmits;
  ULONG                          BaseReachableTime;
  ULONG                          RetransmitTime;
  ULONG                          PathMtuDiscoveryTimeout;
  NL_LINK_LOCAL_ADDRESS_BEHAVIOR LinkLocalAddressBehavior;
  ULONG                          LinkLocalAddressTimeout;
  ULONG                          ZoneIndices[ScopeLevelCount];
  ULONG                          SitePrefixLength;
  ULONG                          Metric;
  ULONG                          NlMtu;
  BOOLEAN                        Connected;
  BOOLEAN                        SupportsWakeUpPatterns;
  BOOLEAN                        SupportsNeighborDiscovery;
  BOOLEAN                        SupportsRouterDiscovery;
  ULONG                          ReachableTime;
  NL_INTERFACE_OFFLOAD_ROD       TransmitOffload;
  NL_INTERFACE_OFFLOAD_ROD       ReceiveOffload;
  BOOLEAN                        DisableDefaultRoutes;
} MIB_IPINTERFACE_ROW, *PMIB_IPINTERFACE_ROW;

Leden

Family-
De adresfamilie. Mogelijke waarden voor de adresfamilie worden vermeld in het headerbestand Winsock2.h. Houd er rekening mee dat de waarden voor de AF_-adresfamilie en PF_ protocolfamilieconstanten identiek zijn (bijvoorbeeld AF_INET en PF_INET), zodat u beide constanten kunt gebruiken.

In Windows Vista en latere versies van de Windows-besturingssystemen worden mogelijke waarden voor dit lid gedefinieerd in het headerbestand Ws2def.h. Houd er rekening mee dat het headerbestand Ws2def.h automatisch wordt opgenomen in Netioapi.h en dat u Ws2def.h nooit rechtstreeks moet gebruiken.

De volgende waarden worden momenteel ondersteund:
- AF_INET
  De IPv4-adresfamilie.
- AF_INET6
  De IPv6-adresfamilie.
- AF_UNSPEC
  De adresfamilie is niet opgegeven.
InterfaceLuid-
De lokaal unieke id (LUID) voor de netwerkinterface.
InterfaceIndex-
De lokale indexwaarde voor de netwerkinterface. Deze indexwaarde kan veranderen wanneer een netwerkadapter is uitgeschakeld en vervolgens is ingeschakeld, of onder andere omstandigheden, en mag niet worden beschouwd als permanent.
MaxReassemblySize
De maximale herassemblygrootte, in bytes, van een gefragmenteerd IP-pakket. Dit lid is momenteel ingesteld op nul en gereserveerd voor toekomstig gebruik.
InterfaceIdentifier-
Gereserveerd voor toekomstig gebruik. Dit lid is momenteel ingesteld op nul.
MinRouterAdvertisementInterval-
Het minimale advertentie-interval van de router, in milliseconden, op deze IP-interface. Dit lid is standaard ingesteld op 200 voor IPv6. Dit lid is alleen van toepassing als het AdvertisingEnabled lid is ingesteld op TRUE.
MaxRouterAdvertisementInterval-
Het maximale interval voor routeradvertenties, in milliseconden, op deze IP-interface. Dit lid is standaard ingesteld op 600 voor IPv6. Dit lid is alleen van toepassing als het AdvertisingEnabled lid is ingesteld op TRUE.
AdvertisingEnabled-
Een waarde die aangeeft of routeradvertenties zijn ingeschakeld op deze IP-interface. De standaardinstelling voor IPv6 is dat routeradvertentie alleen is ingeschakeld als de interface is geconfigureerd om te fungeren als een router. De standaardinstelling voor IPv4 is dat routeradvertentie is uitgeschakeld.
ForwardingEnabled-
Een waarde die aangeeft of doorsturen via IP is ingeschakeld op deze IP-interface.
WeakHostSend-
Een waarde die aangeeft of de zwakke verzendmodus van de host is ingeschakeld op deze IP-interface.
WeakHostReceive-
Een waarde die aangeeft of de modus voor het ontvangen van een zwakke host is ingeschakeld op deze IP-interface.
UseAutomaticMetric
Een waarde die aangeeft of de IP-interface gebruikmaakt van automatische metrische gegevens.
UseNeighborUnreachabilityDetection
Een waarde die aangeeft of detectie van buren onbereikbaarheid is ingeschakeld op deze IP-interface.
ManagedAddressConfigurationSupported
Een waarde die aangeeft of de IP-interface ondersteuning biedt voor de configuratie van beheerde adressen met behulp van DHCP.
OtherStatefulConfigurationSupported
Een waarde die aangeeft of de IP-interface ondersteuning biedt voor andere stateful configuraties (bijvoorbeeld routeconfiguratie).
AdvertiseDefaultRoute
Een waarde die aangeeft of de IP-interface de standaardroute aangeeft. Dit lid is alleen van toepassing als het AdvertisingEnabled lid is ingesteld op TRUE.
RouterDiscoveryBehavior
Een NL_ROUTER_DISCOVERY_BEHAVIOR routerdetectiegedragstype.
DadTransmits-
Het aantal opeenvolgende berichten dat wordt verzonden terwijl het stuurprogramma dubbele adresdetectie uitvoert op een voorlopig IP-unicastadres. Een waarde van nul geeft aan dat dubbele adresdetectie niet wordt uitgevoerd op voorlopig IP-adressen. Een waarde van één geeft aan dat één verzending zonder vervolgtransmissies hoeft te worden verzonden. Voor IPv4 is de standaardwaarde voor dit lid 3. Voor IPv6 is de standaardwaarde voor dit lid 1. Voor IPv6 worden deze berichten verzonden als NS-aanvragen (IPv6 Neighbor Solicitation). Dit lid wordt gedefinieerd als DupAddrDetectTransmits in RFC 2462. Zie IPv6 'Stateless Address Autoconfiguration'voor meer informatie.
BaseReachableTime
De basis voor willekeurige bereikbaar tijd, in milliseconden. Het lid wordt beschreven in RFC 2461. Zie 'Neighbor Discovery for IP Version 6 (IPv6)'voor meer informatie.
RetransmitTime-
De time-out van de IPv6 Neighbor Solicitation (NS) in milliseconden. Het lid wordt beschreven in RFC 2461. Zie 'Neighbor Discovery for IP Version 6 (IPv6)'voor meer informatie.
PathMtuDiscoveryTimeout-
De time-out van de MTU-detectie van het pad, in milliseconden.
LinkLocalAddressBehavior
Een NL_LINK_LOCAL_ADDRESS_BEHAVIOR type lokaal adresgedrag koppelen.
LinkLocalAddressTimeout-
De time-out van het lokale IP-adres van de koppeling, in milliseconden.
ZoneIndices
Een matrix die het zonegedeelte van bereik-id's aangeeft.
SitePrefixLength-
De lengte van het sitevoorvoegsel, in bits, van het IP-interfaceadres. De lengte, in bits, van het sitevoorvoegsel of het netwerkgedeelte van het IP-interfaceadres. Voor een IPv4-adres is elke waarde die groter is dan 32 een ongeldige waarde. Voor een IPv6-adres is elke waarde die groter is dan 128 een ongeldige waarde. Een waarde van 255 wordt meestal gebruikt om een ongeldige waarde weer te geven.
Metrische
De metrische interfacegegevens. Houd er rekening mee dat de werkelijke metrische routegegevens die worden gebruikt voor het berekenen van de routevoorkeur de som van de metrische route-offset die is opgegeven in de Metrische lid van de MIB_IPFORWARD_ROW2-structuur en de metrische interfacegegevens die in dit lid zijn opgegeven.
NlMtu-
De MTU-grootte van de netwerklaag, in bytes.
Verbonden
Een waarde die aangeeft of de interface is verbonden met een netwerktoegangspunt.
SupportsWakeUpPatterns-
Een waarde die aangeeft of de netwerkinterface Wake on LAN ondersteunt.
SupportsNeighborDiscovery-
Een waarde die aangeeft of de IP-interface detectie van buren ondersteunt.
SupportsRouterDiscovery-
Een waarde die aangeeft of de IP-interface detectie van buren ondersteunt.
ReachableTime-
De basis voor willekeurige bereikbaar tijd, in milliseconden. Het lid wordt beschreven in RFC 2461. Zie Neighbor Discovery voor IPv6-(IP-versie 6) voor meer informatie.
TransmitOffload-
Een set vlaggen die de mogelijkheden voor verzenden offload voor de IP-interface aangeven. De NL_INTERFACE_OFFLOAD_ROD structuur wordt gedefinieerd in het headerbestand Nldef.h.
ReceiveOffload-
Een set vlaggen die de mogelijkheden voor het ontvangen van offloads voor de IP-interface aangeven. De NL_INTERFACE_OFFLOAD_ROD structuur wordt gedefinieerd in het headerbestand Nldef.h.
DisableDefaultRoutes
Een waarde die aangeeft of het gebruik van standaardroute op de interface moet worden uitgeschakeld. VPN-clients kunnen dit lid gebruiken om split tunneling te beperken.

Opmerkingen

De Family, InterfaceLuiden InterfaceIndex leden identificeren een MIB_IPINTERFACE_ROW vermelding uniek.

Wanneer een unicastpakket op een host aankomt, moet het IP-adres bepalen of het pakket lokaal is bestemd (de bestemming komt overeen met een adres dat is toegewezen aan een interface van de host). IP-implementaties die volgen op een zwak hostmodel accepteren elk lokaal bestemd pakket, ongeacht de interface waarop het pakket is ontvangen. IP-implementaties die volgen op het sterke hostmodel accepteren alleen lokaal bestemde pakketten als het doeladres in het pakket overeenkomt met een adres dat is toegewezen aan de interface waarop het pakket is ontvangen. Het zwakke hostmodel biedt betere netwerkconnectiviteit. Het maakt hosts echter ook vatbaar voor multihome-gebaseerde netwerkaanvallen.

De huidige IPv4-implementatie in de Windows Server 2003- en Windows XP-besturingssystemen maakt gebruik van het zwakke hostmodel. De TCP/IP-stack op Windows Vista en latere versies van de Windows-besturingssystemen ondersteunt het sterke hostmodel voor zowel IPv4 als IPv6 en is standaard geconfigureerd voor het gebruik van de sterke hostmodus (de WeakHostReceive en WeakHostSend leden zijn ingesteld op FALSE). U kunt de TCP/IP-stack op Windows Vista en later configureren om een zwak hostmodel te gebruiken.

Een metrische waarde is een waarde die is toegewezen aan een IP-route voor een bepaalde netwerkinterface die de kosten identificeert die zijn gekoppeld aan het gebruik van die route. De metrische waarde kan bijvoorbeeld worden bepaald in termen van de snelheid van de koppeling, het aantal hops of de tijdsvertraging. Automatische metrische gegevens zijn een functie in Windows XP en later waarmee automatisch de metrische gegevens worden geconfigureerd voor de lokale routes die zijn gebaseerd op de snelheid van de koppeling. De functie voor automatische metrische gegevens is standaard ingeschakeld (de UseAutomaticMetric- is ingesteld op TRUE) in Windows XP en hoger. U kunt deze functie ook handmatig configureren om een specifieke metrische waarde toe te wijzen aan een IP-route.

De functie voor automatische metrische gegevens kan handig zijn wanneer de routeringstabel meerdere routes voor dezelfde bestemming bevat. Een computer met een netwerkinterface van 10 megabit en een netwerkinterface van 100 megabit heeft bijvoorbeeld een standaardgateway die is geconfigureerd op beide netwerkinterfaces. Wanneer UseAutomaticMetric is TRUE, kan deze functie al het verkeer afdwingen dat bestemd is voor internet, bijvoorbeeld om de snelste netwerkinterface te gebruiken die beschikbaar is.

De metrische interfacegegevens die zijn opgegeven in het Metrische lid vertegenwoordigt alleen de metrische waarde voor de interface. De volledige routeringsmetriek is een combinatie van deze interfacemetriek die is toegevoegd aan de metrische route-offset die is opgegeven in de metrische lid van de MIB_IPFORWARD_ROW2 structuur van een route-vermelding die is opgegeven in deze interface.

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. 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 hoger 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 structuur 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.