IP_INTERFACE_NAME_INFO (Compact 2013)
3/26/2014
Deprecated.
This structure contains information about an IPv4 interface on the local device.
typedef struct {
ULONG Index;
ULONG MediaType;
UCHAR ConnectionType;
UCHAR AccessType;
GUID DeviceGuid;
GUID InterfaceGuid;
} IP_INTERFACE_NAME_INFO;
- 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.
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.
IP Helper Structures
GetAdaptersAddresses
NhpAllocateAndGetInterfaceInfoFromStack