IP_ADAPTER_ADDRESSES

The IP_ADAPTER_ADDRESSES structure is the header node for a linked list of addresses for a particular adapter.

Syntax

typedef struct _IP_ADAPTER_ADDRESSES {
    union {
     ULONGLONG Alignment;
     struct {
      ULONG Length;
      DWORD IfIndex;
     };
    };
	struct _IP_ADAPTER_ADDRESSES	*Next;
        PCHAR AdapterName;
	PIP_ADAPTER_UNICAST_ADDRESS FirstUnicastAddress;
	PIP_ADAPTER_ANYCAST_ADDRESS FirstAnycastAddress;		// Not supported
	PIP_ADAPTER_MULTICAST_ADDRESS FirstMulticastAddress;		// Not supported
	PIP_ADAPTER_DNS_SERVER_ADDRESS FirstDnsServerAddress;		// Not supported
	PWCHAR DnsSuffix;						// Not supported
	PWCHAR Description;
	PWCHAR FriendlyName;
	BYTE PhysicalAddress[MAX_ADAPTER_ADDRESS_LENGTH];
	DWORD PhysicalAddressLength;
	DWORD Flags;
	DWORD Mtu;
	DWORD IfType;
	IF_OPER_STATUS OperStatus;
	DWORD Ipv6IfIndex;
	DWORD ZoneIndices[16];
	PIP_ADAPTER_PREFIX FirstPrefix;					// Not supported
	ULONG64 TransmitLinkSpeed;					
	ULONG64 ReceiveLinkSpeed;					
	PIP_ADAPTER_WINS_SERVER_ADDRESS_LH FirstWinsServerAddress;	// Not supported
	PIP_ADAPTER_GATEWAY_ADDRESS_LH FirstGatewayAddress;
	ULONG Ipv4Metric;						// Not supported
	ULONG Ipv6Metric;						// Not supported
	IF_LUID Luid;							// Not supported
	SOCKET_ADDRESS Dhcpv4Server;					// Not supported
	NET_IF_COMPARTMENT_ID CompartmentId;				// Not supported
	NET_IF_NETWORK_GUID NetworkGuid;				// Not supported
	NET_IF_CONNECTION_TYPE ConnectionType;
	TUNNEL_TYPE TunnelType;						// Not supported
	SOCKET_ADDRESS Dhcpv6Server;					// Not supported
	BYTE Dhcpv6ClientDuid[MAX_DHCPV6_DUID_LENGTH];			// Not supported
	ULONG Dhcpv6ClientDuidLength;					// Not supported
	ULONG Dhcpv6Iaid;						// Not supported
	PIP_ADAPTER_DNS_SUFFIX FirstDnsSuffix;				// Not supported
} IP_ADAPTER_ADDRESSES, *PIP_ADAPTER_ADDRESSES;
	

Members

Alignment

Reserved. Used by the compiler to align the structure.

Length

The length, in bytes, of this structure.

IfIndex

The index of the IPv4 interface with which these addresses are associated.

Next

A pointer to the next adapter addresses structure in the list.

AdapterName

An array of characters that contains the interface name from list of interfaces in Control Panel.

FirstUnicastAddress

A pointer to the first IP_ADAPTER_UNICAST_ADDRESS structure in a linked list of IP unicast addresses for the adapter.

Description

The interface name from list of interfaces in Control Panel.

FriendlyName

The interface name from list of interfaces in Control Panel.

PhysicalAddress

The Media Access Control (MAC) address for the adapter. For example, on an Ethernet network this member would specify the Ethernet hardware address.

PhysicalAddressLength

The length, in bytes, of the address specified in the PhysicalAddress member. For interfaces that do not have a data-link layer, this value is zero.

Flags

A set of flags specifying various settings for the adapter.

Flag	Meaning
IP_ADAPTER_IPV4_ENABLED 0x0080	The adapter is enabled for IPv4.
IP_ADAPTER_IPV6_ENABLED 0x0100	The adapter is enabled for IPv6.

Mtu

The maximum transmission unit (MTU) size, in bytes.

IfType

The interface type as defined by the Internet Assigned Names Authority (IANA).

The table below lists common values for the interface type although many other values are possible.

Value	Meaning
IF_TYPE_ETHERNET_CSMACD 6	An Ethernet network interface.

OperStatus

The operational status for the interface as defined in RFC 2863. For more information, see http://www.ietf.org/rfc/rfc2863.txt.

Value	Meaning
IfOperStatusUp 1	The interface is up and able to pass packets.
IfOperStatusDown 2	The interface is down and not in a condition to pass packets. The IfOperStatusDown state has two meanings, depending on the value of AdminStatus member. If AdminStatus is not set to NET_IF_ADMIN_STATUS_DOWN and ifOperStatus is set to IfOperStatusDown then a fault condition is presumed to exist on the interface. If AdminStatus is set to IfOperStatusDown, then ifOperStatus will normally also be set to IfOperStatusDown or IfOperStatusNotPresent and there is not necessarily a fault condition on the interface.
IfOperStatusTesting 3	The interface is in testing mode.
IfOperStatusUnknown 4	The operational status of the interface is unknown.
IfOperStatusDormant 5	The interface is not actually in a condition to pass packets (it is not up), but is in a pending state, waiting for some external event. For on-demand interfaces, this new state identifies the situation where the interface is waiting for events to place it in the IfOperStatusUp state.
IfOperStatusNotPresent 6	A refinement on the IfOperStatusDown state which indicates that the relevant interface is down specifically because some component (typically, a hardware component) is not present in the managed system.
IfOperStatusLowerLayerDown 7	A refinement on the IfOperStatusDown state. This new state indicates that this interface runs on top of one or more other interfaces and that this interface is down specifically because one or more of these lower-layer interfaces are down.

Ipv6IfIndex

The interface index for the IPv6 IP address. This member is zero if IPv6 is not available on the interface.

ZoneIndices

An array of scope IDs for each scope level used for composing sockaddr structures. The SCOPE_LEVEL enumeration is used to index the array. On IPv6, a single interface may be assigned multiple IPv6 multicast addresses based on a scope ID.

FirstGatewayAddress

A pointer to the first IP_ADAPTER_GATEWAY_ADDRESS structure in a linked list of gateways for the adapter.

ConnectionType

The interface connection type for the adapter address.

Remarks

The GetAdaptersAddresses function retrieves information for IPv4 and IPv6 addresses and returns this information as a linked list of IP_ADAPTER_ADDRESSES structures

Requirements

Minimum Supported Version	RTX64 2014 with Service Pack 2 API changes for RTX64 4.0 Added these members: ReceiveLinkSpeed TransmitLinkSpeed
Header	ws2tcpip.h, iphlpapi.h
Library	Rtx_Rtss.lib

See Also:

GetAdaptersAddresses

IP_ADAPTER_UNICAST_ADDRESS