MIB_IFROW (Compact 2013)

  • Article

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