MIB_IPNET_ROW2 structure

The MIB_IPNET_ROW2 structure stores information about a neighbor IP address.

Syntax


typedef struct _MIB_IPNET_ROW2 {
  SOCKADDR_INET     Address;
  NET_IFINDEX       InterfaceIndex;
  NET_LUID          InterfaceLuid;
  UCHAR             PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
  ULONG             PhysicalAddressLength;
  NL_NEIGHBOR_STATE State;
  union {
    struct {
      BOOLEAN IsRouter  :1;
      BOOLEAN IsUnreachable  :1;
    };
    UCHAR  Flags;
  };
  union {
    ULONG LastReachable;
    ULONG LastUnreachable;
  } ReachabilityTime;
} MIB_IPNET_ROW2, *PMIB_IPNET_ROW2;

Members

Address

The neighbor IP address. This member can be an IPv6 address or an IPv4 address.

InterfaceIndex

The local index value for the network interface that is associated with this IP address. This index value might change when a network adapter is disabled and then enabled, or under other circumstances, and should not be considered persistent.

InterfaceLuid

The locally unique identifier (LUID) for the network interface that is associated with this IP address.

PhysicalAddress

The physical hardware address of the adapter for the network interface that is associated with this IP address.

PhysicalAddressLength

The length, in bytes, of the physical hardware address that the PhysicalAddress member specifies. The maximum value that is supported is 32 bytes.

State

An NL_NEIGHBOR_STATE network layer neighbor state type.

IsRouter

A value that indicates if this IP address is a router.

IsUnreachable

A value that indicates if this IP address is unreachable.

Flags

A set of flags that indicate whether the IP address is a router and whether the IP address is unreachable.

ReachabilityTime

The time that the node assumes that the neighbor is reachable or unreachable after the node receives information about the reachability of the neighbor.

This union contains the following members:

LastReachable

The time, in milliseconds, that a node assumes that the neighbor will remain reachable after the node receives a reachability confirmation from the neighbor.

LastUnreachable

The time, in milliseconds, that a node assumes that the neighbor will remain unreachable after the node fails to receive a reachability confirmation from the neighbor.

Remarks

The GetIpNetTable2 function enumerates the neighbor IP addresses on a local computer and returns this information in an MIB_IPNET_TABLE2 structure. For IPv4, this information includes addresses determined by using the Address Resolution Protocol (ARP). For IPv6, this information includes addresses determined by using the Neighbor Discovery (ND) protocol for IPv6 as specified in RFC 2461. For more information, see Neighbor Discovery for IP Version 6 (IPv6).

The GetIpNetEntry2 function retrieves a single neighbor IP address and returns this information in a MIB_IPNET_ROW2 structure.

Requirements

Version

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

Header

Netioapi.h (include Netioapi.h)

See also

CreateIpNetEntry2
GetIpNetEntry2
GetIpNetTable2
MIB_IPNET_TABLE2
NL_NEIGHBOR_STATE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.