- wszName
A pointer to a Unicode string that contains the name of the interface.
- dwIndex
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.
- dwType
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_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.
|
- dwMtu
The Maximum Transmission Unit (MTU) size in bytes.
- dwSpeed
The speed of the interface in bits per second.
- dwPhysAddrLen
The length, in bytes, of the physical address specified by the bPhysAddr member.
- bPhysAddr
The physical address of the adapter for this interface.
- dwAdminStatus
The interface is administratively enabled or disabled.
- dwOperStatus
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
|
- dwLastChange
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.
- dwInOctets
The number of octets of data received through this interface.
- dwInUcastPkts
The number of unicast packets received through this interface.
- dwInNUcastPkts
The number of non-unicast packets received through this interface. Broadcast and multicast packets are included.
- dwInDiscards
The number of incoming packets that were discarded even though they did not have errors.
- dwInErrors
The number of incoming packets that were discarded because of errors.
- dwInUnknownProtos
The number of incoming packets that were discarded because the protocol was unknown.
- dwOutOctets
The number of octets of data sent through this interface.
- dwOutUcastPkts
The number of unicast packets sent through this interface.
- dwOutNUcastPkts
The number of non-unicast packets sent through this interface. Broadcast and multicast packets are included.
- dwOutDiscards
The number of outgoing packets that were discarded even though they did not have errors.
- dwOutErrors
The number of outgoing packets that were discarded because of errors.
- dwOutQLen
The transmit queue length. This field is not currently used.
- dwDescrLen
The length, in bytes, of the bDescr member.
- bDescr
A description of the interface.
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.