Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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

Header iptypes.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also