Skip to content

Latest commit

 

History

History
471 lines (344 loc) · 12.9 KB

ns-ifmib-mib_ifrow.md

File metadata and controls

471 lines (344 loc) · 12.9 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:ifmib._MIB_IFROW
MIB_IFROW (ifmib.h)
Stores information about a particular interface. (MIB_IFROW)
*PMIB_IFROW
IF_OPER_STATUS_CONNECTED
IF_OPER_STATUS_CONNECTING
IF_OPER_STATUS_DISCONNECTED
IF_OPER_STATUS_NON_OPERATIONAL
IF_OPER_STATUS_OPERATIONAL
IF_OPER_STATUS_UNREACHABLE
IF_TYPE_ATM
IF_TYPE_ETHERNET_CSMACD
IF_TYPE_FDDI
IF_TYPE_IEEE1394
IF_TYPE_IEEE80211
IF_TYPE_IEEE80216_WMAN
IF_TYPE_ISO88025_TOKENRING
IF_TYPE_OTHER
IF_TYPE_PPP
IF_TYPE_SOFTWARE_LOOPBACK
IF_TYPE_TUNNEL
IF_TYPE_WWANPP
IF_TYPE_WWANPP2
MIB_IFROW
MIB_IFROW structure [MIB]
PMIB_IFROW
PMIB_IFROW structure pointer [MIB]
_mpr_mib_ifrow
ifmib/MIB_IFROW
ifmib/PMIB_IFROW
iprtrmib/MIB_IFROW
iprtrmib/PMIB_IFROW
mib.mib_ifrow
rras.mib_ifrow
mib\mib_ifrow.htm
MIB
b08631e9-6036-4377-b2f2-4ea899acb787
12/05/2018
*PMIB_IFROW, IF_OPER_STATUS_CONNECTED, IF_OPER_STATUS_CONNECTING, IF_OPER_STATUS_DISCONNECTED, IF_OPER_STATUS_NON_OPERATIONAL, IF_OPER_STATUS_OPERATIONAL, IF_OPER_STATUS_UNREACHABLE, IF_TYPE_ATM, IF_TYPE_ETHERNET_CSMACD, IF_TYPE_FDDI, IF_TYPE_IEEE1394, IF_TYPE_IEEE80211, IF_TYPE_IEEE80216_WMAN, IF_TYPE_ISO88025_TOKENRING, IF_TYPE_OTHER, IF_TYPE_PPP, IF_TYPE_SOFTWARE_LOOPBACK, IF_TYPE_TUNNEL, IF_TYPE_WWANPP, IF_TYPE_WWANPP2, MIB_IFROW, MIB_IFROW structure [MIB], PMIB_IFROW, PMIB_IFROW structure pointer [MIB], _mpr_mib_ifrow, ifmib/MIB_IFROW, ifmib/PMIB_IFROW, iprtrmib/MIB_IFROW, iprtrmib/PMIB_IFROW, mib.mib_ifrow, rras.mib_ifrow
ifmib.h
Iphlpapi.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Windows
MIB_IFROW, *PMIB_IFROW
19H1
_MIB_IFROW
ifmib/_MIB_IFROW
PMIB_IFROW
ifmib/PMIB_IFROW
MIB_IFROW
ifmib/MIB_IFROW
c++
APIRef
kbSyntax
HeaderDef
Ifmib.h
Iprtrmib.h
MIB_IFROW

MIB_IFROW structure

-description

The MIB_IFROW structure stores information about a particular interface.

-struct-fields

-field wszName

Type: WCHAR[MAX_INTERFACE_NAME_LEN]

A pointer to a Unicode string that contains the name of the interface.

-field dwIndex

Type: DWORD

The index that identifies the interface. This index value may change when a network adapter is disabled and then enabled, and should not be considered persistent.

-field dwType

Type: DWORD

The interface type as defined by the Internet Assigned Names Authority (IANA). For more information, see http://www.iana.org/assignments/ianaiftype-mib. 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_FDDI
15
A Fiber Distributed Data Interface (FDDI) 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.
IF_TYPE_IEEE80216_WMAN
237
A mobile broadband interface for WiMax devices.
Note  This interface type is supported on Windows 7, Windows Server 2008 R2, and later.
 
IF_TYPE_WWANPP
243
A mobile broadband interface for GSM-based devices.
Note  This interface type is supported on Windows 7, Windows Server 2008 R2, and later.
 
IF_TYPE_WWANPP2
244
An mobile broadband interface for CDMA-based devices.
Note  This interface type is supported on Windows 7, Windows Server 2008 R2, and later.
 

-field dwMtu

Type: DWORD

The Maximum Transmission Unit (MTU) size in bytes.

-field dwSpeed

Type: DWORD

The speed of the interface in bits per second.

-field dwPhysAddrLen

Type: DWORD

The length, in bytes, of the physical address specified by the bPhysAddr member.

-field bPhysAddr

Type: BYTE[MAXLEN_PHYSADDR]

The physical address of the adapter for this interface.

-field dwAdminStatus

Type: DWORD

The interface is administratively enabled or disabled.

-field dwOperStatus

Type: DWORD

The operational status of the interface. This member can be one of the following values defined in the INTERNAL_IF_OPER_STATUS enumeration defined in the Ipifcons.h header file.

Value Meaning
IF_OPER_STATUS_NON_OPERATIONAL
LAN adapter has been disabled, for example because of an address conflict.
IF_OPER_STATUS_UNREACHABLE
WAN adapter that is not connected.
IF_OPER_STATUS_DISCONNECTED
For LAN adapters: network cable disconnected. For WAN adapters: no carrier.
IF_OPER_STATUS_CONNECTING
WAN adapter that is in the process of connecting.
IF_OPER_STATUS_CONNECTED
WAN adapter that is connected to a remote peer.
IF_OPER_STATUS_OPERATIONAL
Default status for LAN adapters

-field dwLastChange

Type: DWORD

The length of time, in hundredths of seconds (10^-2 sec), starting from the last computer restart, when the interface entered its current operational state. This value rolls over after 2^32 hundredths of a second.

The dwLastChange member is not currently supported by NDIS. On Windows Vista and later, NDIS returns zero for this member. On earlier versions of Windows, an arbitrary value is returned in this member for the interfaces supported by NDIS. For interfaces supported by other interface providers, they might return an appropriate value.

-field dwInOctets

Type: DWORD

The number of octets of data received through this interface.

-field dwInUcastPkts

Type: DWORD

The number of unicast packets received through this interface.

-field dwInNUcastPkts

Type: DWORD

The number of non-unicast packets received through this interface. Broadcast and multicast packets are included.

-field dwInDiscards

Type: DWORD

The number of incoming packets that were discarded even though they did not have errors.

-field dwInErrors

Type: DWORD

The number of incoming packets that were discarded because of errors.

-field dwInUnknownProtos

Type: DWORD

The number of incoming packets that were discarded because the protocol was unknown.

-field dwOutOctets

Type: DWORD

The number of octets of data sent through this interface.

-field dwOutUcastPkts

Type: DWORD

The number of unicast packets sent through this interface.

-field dwOutNUcastPkts

Type: DWORD

The number of non-unicast packets sent through this interface. Broadcast and multicast packets are included.

-field dwOutDiscards

Type: DWORD

The number of outgoing packets that were discarded even though they did not have errors.

-field dwOutErrors

Type: DWORD

The number of outgoing packets that were discarded because of errors.

-field dwOutQLen

Type: DWORD

The transmit queue length. This field is not currently used.

-field dwDescrLen

Type: DWORD

The length, in bytes, of the bDescr member.

-field bDescr

Type: BYTE[MAXLEN_IFDESCR]

A description of the interface.

-remarks

The dwSpeed member of the MIB_IFROW structure will be incorrect for very high-speed network interfaces (10 Gbit/s network adapter, for example) since the maximum value that can be store in a DWORD is 4,294,967,295. Applications should use the MIB_IF_ROW2 structure returned by the GetIfEntry2 and GetIfTable2 functions or the IP_ADAPTER_ADDRESSES structure returned by the GetAdaptersAddresses function for determining the speed for very high-speed network interfaces.

On the Microsoft Windows Software Development Kit (SDK) released for Windows Vista and later, the organization of header files has changed and the MIB_IFROW structure is defined in the Ifmib.h header file not in the Iprtrmib.h header file. Note that the Ifmib.h header file is automatically included in Iprtrmib.h which is automatically included in the Iphlpapi.h header file. The Ifmib.h and Iprtrmib.h header files should never be used directly.

-see-also

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0