MIB_IFROW (Compact 2013)

3/26/2014

This structure stores information about a particular interface.

Syntax

typedef struct _MIB_IFROW {
  WCHAR wszName[MAX_INTERFACE_NAME_LEN];
  DWORD dwIndex; 
  DWORD dwType; 
  DWORD dwMtu; 
  DWORD dwSpeed; 
  DWORD dwPhysAddrLen; 
  BYTE bPhysAddr[MAXLEN_PHYSADDR]; 
  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[MAXLEN_IFDESCR]; 
} MIB_IFROW, *PMIB_IFROW;

Members

• wszName
  Pointer to a Unicode string that contains the name of the interface.

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

• dwType
  The type of interface.

  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.

• dwMtu
  The maximum transmission unit (MTU) of the underlying hardware.

• dwSpeed
  The speed of the interface in bits per second.

• dwPhysAddrLen
  The length 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. The following table shows the possible values for this member.

  Value	Meaning
  MIB_IF_OPER_STATUS_NON_OPERATIONAL	LAN adapter has been disabled, for example because of an address conflict.
  MIB_IF_OPER_STATUS_UNREACHABLE	WAN adapter that is not connected.
  MIB_IF_OPER_STATUS_DISCONNECTED	No carrier.
  MIB_IF_OPER_STATUS_CONNECTING	WAN adapter that is connecting.
  MIB_IF_OPER_STATUS_CONNECTED	WAN adapter that is connected to a remote peer.
  MIB_IF_OPER_STATUS_OPERATIONAL	Default status for LAN adapters.

• dwLastChange
  The last time that the operational status changed.

• dwInOctets
  The number of octets of data that is 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. This includes broadcast and multicast packets.

• 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. Number of octets equals number of bytes.

• dwOutUcastPkts
  The number of unicast packets sent through this interface.

• dwOutNUcastPkts
  The number of non-unicast packets sent through this interface. This includes broadcast and multicast packets.

• 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 output queue length.

• dwDescrLen
  The length of the bDescr member.

• bDescr
  Contains a description of the interface.

Remarks

The header files organization has changed and the MIB_IFROW structure is defined in the Ifmib.h header file instead of in the Iprtrmib.h header file. Be aware 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.

Requirements

Header

iprtrmib.h, ws2def.h, ws2ipdef.h

See Also

Reference

MIB Structures
IP Helper Structures
GetIfEntry
MIB_IFTABLE
MIB_IFSTATUS