IP_ADAPTER_INFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains information about a particular network adapter on the local computer.

Syntax

typedef struct _IP_ADAPTER_INFO {
  struct _IP_ADAPTER_INFO* Next;
  DWORD ComboIndex;
  Char AdapterName[MAX_ADAPTER_NAME_LENGTH + 4];
  char Description[MAX_ADAPTER_DESCRIPTION_LENGTH + 4];
  UINT AddressLength;
  BYTE Address[MAX_ADAPTER_ADDRESS_LENGTH];
  DWORD Index;
  UINT Type;
  UINT DhcpEnabled;
  PIP_ADDR_STRING CurrentIpAddress;
  IP_ADDR_STRING IpAddressList;
  IP_ADDR_STRING GatewayList;
  IP_ADDR_STRING DhcpServer;
  BOOL HaveWins;
  IP_ADDR_STRING PrimaryWinsServer;
  IP_ADDR_STRING SecondaryWinsServer;
  time_t LeaseObtained;
  time_t LeaseExpires;
} IP_ADAPTER_INFO, *PIP_ADAPTER_INFO;

Members

• Next
  Pointer to the next adapter in the linked list of adapters.

• ComboIndex
  Reserved.

• AdapterName
  The name of the adapter.

• Description
  A description for the adapter.

• AddressLength
  The length of hardware address for the adapter.

• Address
  The hardware address for the adapter.

• Index
  The adapter index.

• Type
  The adapter type. The following list shows the adapter type values as they are defined in the header file IPIfCons.h:

  • MIB_IF_TYPE_OTHER     1
  • MIB_IF_TYPE_ETHERNET     6
  • MIB_IF_TYPE_TOKENRING     9
  • MIB_IF_TYPE_FDDI     15
  • MIB_IF_TYPE_PPP     23
  • MIB_IF_TYPE_LOOPBACK      24
  • MIB_IF_TYPE_SLIP      28

• DhcpEnabled
  TRUE if dynamic host configuration protocol (DHCP) is enabled for this adapter.

• CurrentIpAddress
  The current IP address for this adapter.

• IpAddressList
  The list of IP addresses associated with this adapter.

• GatewayList
  The IP address of the default gateway for this adapter.

• DhcpServer
  The IP address of the DHCP server for this adapter.

• HaveWins
  TRUE if this adapter uses Windows Internet Name Service (WINS).

• PrimaryWinsServer
  The IP address of the primary WINS server.

• SecondaryWinsServer
  The IP address of the secondary WINS server.

• LeaseObtained
  The time when the current DHCP lease was obtained.

• LeaseExpires
  The time when the current DHCP lease will expire.

Requirements

See Also

Reference

IP Helper Structures
GetAdaptersInfo