IP_INTERFACE_NAME_INFO (Compact 2013)

3/26/2014

Deprecated.

This structure contains information about an IPv4 interface on the local device.

Syntax

typedef struct {
  ULONG Index;
  ULONG MediaType;
  UCHAR ConnectionType;
  UCHAR AccessType;
  GUID DeviceGuid;
  GUID InterfaceGuid;
} IP_INTERFACE_NAME_INFO;

Members

• Index
  The index of the IP interface for the active instance.

• MediaType
  The interface type as defined by the Internet Assigned Names Authority (IANA). Possible values for the interface type are listed in the Ipifcons.h header file.

  The following table lists common values for the interface type although many other values are possible.

  Value	Meaning
  IF_TYPE_OTHER 1	Some other type of network interface.
  IF_TYPE_ETHERNET_CSMACD 6	An Ethernet network interface.
  IF_TYPE_ISO88025_TOKENRING 9	A token ring network interface.
  IF_TYPE_PPP 23	A PPP network interface.
  IF_TYPE_SOFTWARE_LOOPBACK 24	A software loopback network interface.
  IF_TYPE_ATM 37	An ATM network interface.
  IF_TYPE_IEEE80211 71	An IEEE 802.11 wireless network interface.
  IF_TYPE_TUNNEL 131	A tunnel type encapsulation network interface.
  IF_TYPE_IEEE1394 144	An IEEE 1394 (Firewire) high performance serial bus network interface.

• ConnectionType
  The interface connection type for the adapter.

  The possible values for this member are defined in the Ipifcons.h header file.

  Value	Meaning
  IF_CONNECTION_DEDICATED 1	The connection type is dedicated. The connection comes up automatically when media sense is TRUE. For example, an Ethernet connection is dedicated.
  IF_CONNECTION_PASSIVE 2	The connection type is passive. The remote end must bring up the connection to the local station. For example, a RAS interface is passive.
  IF_CONNECTION_DEMAND 3	The connection type is demand-dial. A connection of this type comes up in response to a local action (sending a packet, for example).

• AccessType
  The access type for the interface. Possible values for the access type are listed in the Ipifcons.h header file.

  This member can be one of the values from the IF_ACCESS_TYPE enumeration type that is defined in the Ipifcons.h header file.

  The possible values for this member are defined in the Ipifcons.h header file:

  Value	Meaning
  IF_ACCESS_LOOPBACK 1	The loopback access type. This value indicates that the interface loops back transmit data as receive data.
  IF_ACCESS_BROADCAST 2	The LAN access type which includes Ethernet. This value indicates that the interface provides native support for multicast or broadcast services.
  IF_ACCESS_POINT_TO_POINT 3	The point to point access type. This value indicates support for CoNDIS/WAN, except for non-broadcast multi-access (NBMA) interfaces. Prior, this value was defined as IF_ACCESS_POINTTOPOINT in the Ipifcons.h header file.
  IF_ACCESS_POINT_TO_MULTI_POINT 4	The point to multipoint access type. This value indicates support for non-broadcast multi-access media, including the RAS internal interface and native ATM. Prior, this value was defined as IF_ACCESS_POINTTOMULTIPOINT in the Ipifcons.h header file.

• DeviceGuid
  The GUID that identifies the underlying device for the interface. This member can be a zero GUID.

• InterfaceGuid
  The GUID that identifies the interface mapped to the device. Optional. This member can be a zero GUID.

Remarks

The NhpAllocateAndGetInterfaceInfoFromStack function obtains adapter information about the local device and returns this information as an array of IP_INTERFACE_NAME_INFO structures. The NhpAllocateAndGetInterfaceInfoFromStack function has been deprecated. The GetAdaptersAddresses function and the associated IP_ADAPTER_ADDRESSES structure should be used instead.

The MediaType, ConnectionType, and AccessType members, definitions and assigned values are available from the Ipifcons.h header file.

The optional InterfaceGuid member is frequently set for dial-up interfaces, and can be used to distinguish multiple dial-up interfaces that share the same device GUID.

See Also

Reference

IP Helper Structures
GetAdaptersAddresses
NhpAllocateAndGetInterfaceInfoFromStack