IP_ADAPTER_ADDRESSES (Windows Embedded CE 6.0)
1/6/2010
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.
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;
PIP_ADAPTER_MULTICAST_ADDRESS FirstMulticastAddress;
PIP_ADAPTER_DNS_SERVER_ADDRESS FirstDnsServerAddress;
PWCHAR DnsSuffix;
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;
} 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
| Header | iptypes.h |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Note | IP Helper Structures |
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.
IP_ADAPTER_RECEIVE_ONLY
The adapter is a receive-only adapter.
IP_ADAPTER_NO_MULTICAST
The adapter is not a multicast recipient.
IP_ADAPTER_IPV6_OTHER_STATEFUL_CONFIG
The adapter contains other IPv6-specific stateful configuration information.
- DdnsEnabled
Dynamic DNS is enabled on the adapter.
- RegisterAdapterSuffix
Register the DNS suffix for the adapter.
- Dhcpv4Enabled
Dynamic Host Configuration Protocol (DHCP) is enabled for the adapter.
- ReceiveOnly
The adapter is a receive-only adapter.
- NoMulticast
The adapter is not a multicast recipient.
- Ipv6OtherStatefulConfig
The adapter contains other IPv6-specific stateful configuration information.
- NetbiosOverTcpipEnabled
NetBIOS over TCPIP is enabled for the adapter.
- Ipv4Enabled
IPv4 is enabled for the adapter.
- Ipv6Enabled
IPv4 is enabled for 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.
- PhysicalMedium
The physical medium. Possible values are defined in NDIS_PHYSICAL_MEDIUM (see Ntddndis.h). The PhysicalMedium member is initialized to the OID_GEN_PHYSICAL_MEDIUM response from the 802.3 miniport driver.
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
| Header | iptypes.h |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Note | IP Helper Structures |