IP_ADAPTER_ADDRESSES (Windows CE 5.0)
This structure is the "header node" for a linked list of addresses for a particular adapter. This structure can simultaneously be used as part of a linked list of IP_ADAPTER_ADDRESSES structures.
typedef struct _IP_ADAPTER_ADDRESSES {union {ULONGLONG Alignment;
struct {ULONGLength;DWORDIfIndex;};};struct _IP_ADAPTER_ADDRESSES*Next;PCHARAdapterName;PIP_ADAPTER_UNICAST_ADDRESSFirstUnicastAddress;PIP_ADAPTER_ANYCAST_ADDRESSFirstAnycastAddress;PIP_ADAPTER_MULTICAST_ADDRESSFirstMulticastAddress;PIP_ADAPTER_DNS_SERVER_ADDRESSFirstDnsServerAddress;PWCHARDnsSuffix;PWCHARDescription;PWCHARFriendlyName;BYTE PhysicalAddress[MAX_ADAPTER_ADDRESS_LENGTH];DWORDPhysicalAddressLength;DWORD Flags;
DWORDMtu;DWORDIfType;IF_OPER_STATUSOperStatus; DWORD Ipv6IfIndex;
DWORD ZoneIndices[16];
PIP_ADAPTER_PREFIX FirstPrefix;
} IP_ADAPTER_ADDRESSES, *PIP_ADAPTER_ADDRESSES;
Members
- Alignment
Reserved. Used by the compiler to align the structure. - Length
The length of this structure. - IfIndex
The index of the interface with which these addresses are associated. - Next
Pointer to the next list of adapter addresses. - AdapterName
An array of characters that contains the name of the adapter with which these addresses are associated. - FirstUnicastAddress
Pointer to the first IP_ADAPTER_UNICAST_ADDRESS structure in the list of addresses for the adapter specified by AdapterName. - FirstAnycastAddress
Pointer to the first IP_ADAPTER_ANYCAST_ADDRESS structure in the list of addresses for the adapter specified by AdapterName. - FirstMulticastAddress
Pointer to the first IP_ADAPTER_MULTICAST_ADDRESS structure in the list of addresses for the adapter specified by AdapterName. - FirstDnsServerAddress
Pointer to the first IP_ADAPTER_DNS_SERVER_ADDRESS structure in the list of addresses for the adapter specified by AdapterName. - DnsSuffix
The DNS suffix associated with this adapter. - Description
A description for the adapter. - FriendlyName
A user-friendly name. This name appears in contexts such as the ipconfig command line program and the Connection folder. - PhysicalAddress
The Media Access Control (MAC) address for the adapter. For example, on an Ethernet network, this member will specify the Ethernet address. - PhysicalAddressLength
The length of the address specified in the PhysicalAddress member. For interfaces that do not have a data-link layer, this value is zero. - Flags
A combination of adapter flags. The following table shows the possible flags.Flag Description IP_ADAPTER_DDNS_ENABLED Dynamic DNS is enabled for the adapter. IP_ADAPTER_REGISTER_ADAPTER_SUFFIX Register the DNS suffix for the adapter. IP_ADAPTER_DHCP_ENABLED Dynamic Host Configuration Protocol (DHCP) is enabled on the adapter. - Mtu
The maximum transmission unit (MTU), in bytes. - IfType
The type of interface using the values defined by the Internet Assigned Numbers Authority (IANA). These values are listed in the header file Ipifcons.h. - OperStatus
The operational status of the interface using the values defined in RFC2863. These values are listed in the header file Iptypes.h. - Ipv6IfIndex
The interface index for the IPv6 IP address. Contains zero if IPv6 is not available on the interface. - ZoneIndices[16]
The array of Scope IDs for each scope level. Used for composing sockaddr structures. The SCOPE_LEVEL enumeration is used to index the array. - FirstPrefix
The pointer to the first adapter prefix in the IPv6IfIndex member.
Remarks
An application can query the OperStatus member to discover the current status of network connectivity. This status is not subject to media sense damping intervals. For example, when the connectivity status of an interface changes, OperStatus immediately changes to reflect the current state. This change in connectivity status will have no effect on the TCP/IP stack until the damping interval expires.
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Iptypes.h.
See Also
Send Feedback on this topic to the authors