Edit

Share via


MIB_IPINTERFACE_ROW structure

The MIB_IPINTERFACE_ROW structure stores interface management information for a particular IP address family on a network interface.

Syntax

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;

Members

  • Family
    The address family. Possible values for the address family are listed in the Winsock2.h header file. Note that the values for the AF_ address family and PF_ protocol family constants are identical (for example, AF_INET and PF_INET), so you can use either constant.

    On Windows Vista and later versions of the Windows operating systems, possible values for this member are defined in the Ws2def.h header file. Note that the Ws2def.h header file is automatically included in Netioapi.h and you should never use Ws2def.h directly.

    The following values are currently supported:

    • AF_INET
      The IPv4 address family.

    • AF_INET6
      The IPv6 address family.

    • AF_UNSPEC
      The address family is unspecified.

  • InterfaceLuid
    The locally unique identifier (LUID) for the network interface.

  • InterfaceIndex
    The local index value for the network interface. This index value might change when a network adapter is disabled and then enabled, or under other circumstances, and should not be considered persistent.

  • MaxReassemblySize
    The maximum reassembly size, in bytes, of a fragmented IP packet. This member is currently set to zero and reserved for future use.

  • InterfaceIdentifier
    Reserved for future use. This member is currently set to zero.

  • MinRouterAdvertisementInterval
    The minimum router advertisement interval, in milliseconds, on this IP interface. This member defaults to 200 for IPv6. This member is applicable only if the AdvertisingEnabled member is set to TRUE.

  • MaxRouterAdvertisementInterval
    The maximum router advertisement interval, in milliseconds, on this IP interface. This member defaults to 600 for IPv6. This member is applicable only if the AdvertisingEnabled member is set to TRUE.

  • AdvertisingEnabled
    A value that indicates if router advertising is enabled on this IP interface. The default for IPv6 is that router advertisement is enabled only if the interface is configured to act as a router. The default for IPv4 is that router advertisement is disabled.

  • ForwardingEnabled
    A value that indicates if IP forwarding is enabled on this IP interface.

  • WeakHostSend
    A value that indicates if weak host send mode is enabled on this IP interface.

  • WeakHostReceive
    A value that indicates if weak host receive mode is enabled on this IP interface.

  • UseAutomaticMetric
    A value that indicates if the IP interface uses automatic metric.

  • UseNeighborUnreachabilityDetection
    A value that indicates if neighbor unreachability detection is enabled on this IP interface.

  • ManagedAddressConfigurationSupported
    A value that indicates if the IP interface supports managed address configuration by using DHCP.

  • OtherStatefulConfigurationSupported
    A value that indicates if the IP interface supports other stateful configuration (for example, route configuration).

  • AdvertiseDefaultRoute
    A value that indicates if the IP interface advertises the default route. This member is applicable only if the AdvertisingEnabled member is set to TRUE.

  • RouterDiscoveryBehavior
    An NL_ROUTER_DISCOVERY_BEHAVIOR router discovery behavior type.

  • DadTransmits
    The number of consecutive messages that are sent while the driver performs duplicate address detection on a tentative IP unicast address. A value of zero indicates that duplicate address detection is not performed on tentative IP addresses. A value of one indicates a single transmission with no follow up retransmissions. For IPv4, the default value for this member is 3. For IPv6, the default value for this member is 1. For IPv6, these messages are sent as IPv6 Neighbor Solicitation (NS) requests. This member is defined as DupAddrDetectTransmits in RFC 2462. For more information, see IPv6 "Stateless Address Autoconfiguration".

  • BaseReachableTime
    The base for random reachable time, in milliseconds. The member is described in RFC 2461. For more information, see "Neighbor Discovery for IP Version 6 (IPv6)".

  • RetransmitTime
    The IPv6 Neighbor Solicitation (NS) time-out, in milliseconds. The member is described in RFC 2461. For more information, see "Neighbor Discovery for IP Version 6 (IPv6)".

  • PathMtuDiscoveryTimeout
    The path MTU discovery time-out, in milliseconds.

  • LinkLocalAddressBehavior
    A NL_LINK_LOCAL_ADDRESS_BEHAVIOR link local address behavior type.

  • LinkLocalAddressTimeout
    The link local IP address time-out, in milliseconds.

  • ZoneIndices
    An array that specifies the zone part of scope IDs.

  • SitePrefixLength
    The site prefix length, in bits, of the IP interface address. The length, in bits, of the site prefix or network part of the IP interface address. For an IPv4 address, any value that is greater than 32 is an illegal value. For an IPv6 address, any value that is greater than 128 is an illegal value. A value of 255 is typically used to represent an illegal value.

  • Metric
    The interface metric. Note that the actual route metric that is used to compute the route preference is the summation of the route metric offset that is specified in the Metric member of the MIB_IPFORWARD_ROW2 structure and the interface metric that is specified in this member.

  • NlMtu
    The network layer MTU size, in bytes.

  • Connected
    A value that indicates if the interface is connected to a network access point.

  • SupportsWakeUpPatterns
    A value that specifies if the network interface supports Wake on LAN.

  • SupportsNeighborDiscovery
    A value that specifies if the IP interface support neighbor discovery.

  • SupportsRouterDiscovery
    A value that specifies if the IP interface support neighbor discovery.

  • ReachableTime
    The base for random reachable time, in milliseconds. The member is described in RFC 2461. For more information, see Neighbor Discovery for IP Version 6 (IPv6).

  • TransmitOffload
    A set of flags that indicate the transmit offload capabilities for the IP interface. The NL_INTERFACE_OFFLOAD_ROD structure is defined in the Nldef.h header file.

  • ReceiveOffload
    A set of flags that indicate the receive offload capabilities for the IP interface. The NL_INTERFACE_OFFLOAD_ROD structure is defined in the Nldef.h header file.

  • DisableDefaultRoutes
    A value that indicates if using default route on the interface should be disabled. VPN clients can use this member to restrict split tunneling.

Remarks

The Family, InterfaceLuid, and InterfaceIndex members uniquely identify a MIB_IPINTERFACE_ROW entry.

When a unicast packet arrives at a host, IP must determine whether the packet is locally destined (its destination matches an address that is assigned to an interface of the host). IP implementations that follow a weak host model accept any locally destined packet, regardless of the interface that the packet was received on. IP implementations that follow the strong host model accept only locally destined packets if the destination address in the packet matches an address that is assigned to the interface that the packet was received on. The weak host model provides better network connectivity. However, it also makes hosts susceptible to multihome-based network attacks.

The current IPv4 implementation in the Windows Server 2003 and Windows XP operating systems uses the weak host model. The TCP/IP stack on Windows Vista and later versions of the Windows operating systems supports the strong host model for both IPv4 and IPv6 and is configured to use the strong host mode by default (the WeakHostReceive and WeakHostSend members are set to FALSE). You can configure the TCP/IP stack on Windows Vista and later to use a weak host model.

A metric is a value that is assigned to an IP route for a particular network interface that identifies the cost that is associated with using that route. For example, the metric can be valued in terms of link speed, hop count, or time delay. Automatic metric is a feature on Windows XP and later that automatically configures the metric for the local routes that are based on link speed. By default, the automatic metric feature is enabled (the UseAutomaticMetric is set to TRUE) on Windows XP and later. You can also manually configure this feature to assign a specific metric to an IP route.

The automatic metric feature can be useful when the routing table contains multiple routes for the same destination. For example, a computer that has a 10 megabit network interface and a 100 megabit network interface has a default gateway that is configured on both network interfaces. When UseAutomaticMetric is TRUE, this feature can force all traffic that is destined for the Internet, for example, to use the fastest network interface that is available.

The interface metric that is specified in the Metric member represents only the metric for the interface. The complete routing metric is a combination of this interface metric added to the route metric offset that is specified in the Metric member of the MIB_IPFORWARD_ROW2 structure of a route entry that is specified on this interface.

Unprivileged simultaneous access to multiple networks of different security requirements creates a security hole and enables an unprivileged driver to accidentally relay data between the two networks. A typical example is simultaneous access to a virtual private network (VPN) and the Internet. Windows Server 2003 and Windows XP use a weak host model, where Remote Access Service (RAS) prevents such simultaneous access by increasing the route metric of all default routes over other interfaces. Therefore, all traffic is routed through the VPN interface, disrupting other network connectivity.

On Windows Vista and later, by default, a strong host model is used. If a source IP address is specified in the route lookup by using the GetBestRoute2 function, the route lookup is restricted to the interface of the source IP address. The route metric modification by RAS has no effect because the list of potential routes does not even have the route for the VPN interface, which enables traffic to the Internet. Your driver can use the DisableDefaultRoutes member of the MIB_IPINTERFACE_ROW structure to disable using the default route on an interface. VPN clients can use this member as a security measure to restrict split tunneling when split tunneling is not required by the VPN client. A VPN client can call the SetIpInterfaceEntry function to set the DisableDefaultRoutes member to TRUE when it is required. A VPN client can query the current state of the DisableDefaultRoutes member by calling the GetIpInterfaceEntry function.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Netioapi.h (include Netioapi.h)

See also

GetBestRoute2

GetIpInterfaceEntry

MIB_IPFORWARD_ROW2

MIB_IPINTERFACE_TABLE

NET_LUID

NL_LINK_LOCAL_ADDRESS_BEHAVIOR

NL_ROUTER_DISCOVERY_BEHAVIOR

SetIpInterfaceEntry