2.2.1.2.29 MIB_IFROW

The MIB_IFROW structure stores information about a specific interface.

 typedef struct _MIB_IFROW {
   WCHAR wszName[256];
   DWORD dwIndex;
   DWORD dwType;
   DWORD dwMtu;
   DWORD dwSpeed;
   DWORD dwPhysAddrLen;
   BYTE bPhysAddr[8];
   DWORD dwAdminStatus;
   DWORD dwOperStatus;
   DWORD dwLastChange;
   DWORD dwInOctets;
   DWORD dwInUcastPkts;
   DWORD dwInNUcastPkts;
   DWORD dwInDiscards;
   DWORD dwInErrors;
   DWORD dwInUnknownProtos;
   DWORD dwOutOctets;
   DWORD dwOutUcastPkts;
   DWORD dwOutNUcastPkts;
   DWORD dwOutDiscards;
   DWORD dwOutErrors;
   DWORD dwOutQLen;
   DWORD dwDescrLen;
   BYTE bDescr[256];
 } MIB_IFROW;

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

dwIndex: The index that identifies the interface. This index value is not persistent and can change when a network adapter is disabled and then enabled.

dwType: The interface type as defined by the Internet Assigned Names Authority (IANA) [IANAifType].

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

Value	Meaning
IF_TYPE_OTHER 0x00000001	Another type of network interface.
IF_TYPE_ETHERNET_CSMACD 0x00000006	An Ethernet network interface.
IF_TYPE_ISO88025_TOKENRING 0x00000009	A token ring network interface.
IF_TYPE_PPP 0x00000017	A PPP network interface.
IF_TYPE_SOFTWARE_LOOPBACK 0x00000018	A software loopback network interface.
IF_TYPE_ATM 0x00000027	An ATM network interface.
IF_TYPE_IEEE80211 0x00000047	An IEEE 802.11 wireless network interface.
IF_TYPE_TUNNEL 0x00000083	A tunnel type encapsulation network interface.
IF_TYPE_IEEE1394 0x00000090	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 administrative status of the interface. It can be either enabled or disabled.

dwOperStatus: The operational status of the interface.

This member can be one of the following values.

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

dwLastChange: The length of time, in hundredths of seconds, starting from the last computer restart, when the interface entered its current operational state.<32>

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 nonunicast 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 nonunicast 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 null-terminated ASCII string that contains the description of the interface.