Skip to content

Latest commit

 

History

History
335 lines (263 loc) · 9.8 KB

ns-iptypes-ip_interface_name_info_w2ksp1.md

File metadata and controls

335 lines (263 loc) · 9.8 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:iptypes.ip_interface_name_info_w2ksp1
IP_INTERFACE_NAME_INFO_W2KSP1 (iptypes.h)
Contains information about an IPv4 interface on the local computer.
*PIP_INTERFACE_NAME_INFO
*PIP_INTERFACE_NAME_INFO_W2KSP1
IF_ACCESS_BROADCAST
IF_ACCESS_LOOPBACK
IF_ACCESS_POINT_TO_MULTI_POINT
IF_ACCESS_POINT_TO_POINT
IF_CONNECTION_DEDICATED
IF_CONNECTION_DEMAND
IF_CONNECTION_PASSIVE
IF_TYPE_ATM
IF_TYPE_ETHERNET_CSMACD
IF_TYPE_IEEE1394
IF_TYPE_IEEE80211
IF_TYPE_ISO88025_TOKENRING
IF_TYPE_OTHER
IF_TYPE_PPP
IF_TYPE_SOFTWARE_LOOPBACK
IF_TYPE_TUNNEL
IP_INTERFACE_NAME_INFO
IP_INTERFACE_NAME_INFO structure [IP Helper]
IP_INTERFACE_NAME_INFO_W2KSP1
iphlp.ip_interface_name_info
iptypes/IP_INTERFACE_NAME_INFO
iphlp\ip_interface_name_info.htm
IpHlp
c113e97d-6f41-490a-a872-20d662fd763b
12/05/2018
*PIP_INTERFACE_NAME_INFO, *PIP_INTERFACE_NAME_INFO_W2KSP1, IF_ACCESS_BROADCAST, IF_ACCESS_LOOPBACK, IF_ACCESS_POINT_TO_MULTI_POINT, IF_ACCESS_POINT_TO_POINT, IF_CONNECTION_DEDICATED, IF_CONNECTION_DEMAND, IF_CONNECTION_PASSIVE, IF_TYPE_ATM, IF_TYPE_ETHERNET_CSMACD, IF_TYPE_IEEE1394, IF_TYPE_IEEE80211, IF_TYPE_ISO88025_TOKENRING, IF_TYPE_OTHER, IF_TYPE_PPP, IF_TYPE_SOFTWARE_LOOPBACK, IF_TYPE_TUNNEL, IP_INTERFACE_NAME_INFO, IP_INTERFACE_NAME_INFO structure [IP Helper], IP_INTERFACE_NAME_INFO_W2KSP1, iphlp.ip_interface_name_info, iptypes/IP_INTERFACE_NAME_INFO
iptypes.h
Iphlpapi.h
Windows
Windows XP, Windows 2000 Professional with SP1 [desktop apps only]
Windows Server 2003, Windows 2000 Server with SP1 [desktop apps only]
Windows
IP_INTERFACE_NAME_INFO_W2KSP1, *PIP_INTERFACE_NAME_INFO_W2KSP1
19H1
ip_interface_name_info_w2ksp1
iptypes/ip_interface_name_info_w2ksp1
PIP_INTERFACE_NAME_INFO_W2KSP1
iptypes/PIP_INTERFACE_NAME_INFO_W2KSP1
IP_INTERFACE_NAME_INFO_W2KSP1
iptypes/IP_INTERFACE_NAME_INFO_W2KSP1
c++
APIRef
kbSyntax
HeaderDef
Iptypes.h
IP_INTERFACE_NAME_INFO

IP_INTERFACE_NAME_INFO_W2KSP1 structure

-description

The IP_INTERFACE_NAME_INFO structure contains information about an IPv4 interface on the local computer.

-struct-fields

-field Index

Type: ULONG

The index of the IP interface for the active instance.

-field MediaType

Type: ULONG

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 table below 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. On Windows Vista and later, wireless network cards are reported as IF_TYPE_IEEE80211.

Windows Server 2003, Windows 2000 Server with SP1 and Windows XP/2000:  Wireless network cards are reported as IF_TYPE_ETHERNET_CSMACD.

IF_TYPE_TUNNEL
131
A tunnel type encapsulation network interface.
IF_TYPE_IEEE1394
144
An IEEE 1394 (Firewire) high performance serial bus network interface.

-field ConnectionType

Type: UCHAR

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).

-field AccessType

Type: UCHAR

A value of the IF_ACCESS_TYPE enumeration that specifies the access type for the interface.

Windows Server 2003, Windows 2000 Server with SP1 and Windows XP/2000:  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.

Windows Server 2003, Windows 2000 Server with SP1 and Windows XP/2000:  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.

Windows Server 2003, Windows 2000 Server with SP1 and Windows XP/2000:  This value was defined as IF_ACCESS_POINTTOMULTIPOINT in the Ipifcons.h header file.

-field DeviceGuid

Type: GUID

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

-field InterfaceGuid

Type: GUID

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

-remarks

In the Microsoft Windows Software Development Kit (SDK), the version of the structure for use on Windows 2000 with Service Pack 1 (SP1) and later is defined as IP_INTERFACE_NAME_INFO_W2KSP1. When compiling an application if the target platform is Windows 2000 with SP1 and later (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500, or WINVER >= 0x0500), the IP_INTERFACE_NAME_INFO_W2KSP1 structure is typedefed to the IP_INTERFACE_NAME_INFO structure.

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

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

-see-also

GetAdaptersAddresses

NhpAllocateAndGetInterfaceInfoFromStack