Partager via

IP_ADAPTER_ADDRESSES

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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
Windows Mobile Windows Mobile Version 5.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
Windows Mobile Windows Mobile Version 5.0 and later
Note IP Helper Structures

See Also

Reference

IP Helper Structures