MIB_IFROW

The MIB_IFROW structure stores information about a particular interface.

typedef struct _MIB_IFROW {
  WCHAR   wszName[MAX_INTERFACE_NAME_LEN];
  DWORD   dwIndex;    // index of the interface
  DWORD   dwType;     // type of interface
  DWORD   dwMtu;      // max transmission unit 
  DWORD   dwSpeed;    // speed of the interface 
  DWORD   dwPhysAddrLen;    // length of physical address
  BYTE    bPhysAddr[MAXLEN_PHYSADDR]; // physical address of adapter
  DWORD   dwAdminStatus;    // administrative status
  DWORD   dwOperStatus;     // operational status
  DWORD   dwLastChange;     // last time operational status changed 
  DWORD   dwInOctets;       // octets received
  DWORD   dwInUcastPkts;    // unicast packets received 
  DWORD   dwInNUcastPkts;   // non-unicast packets received 
  DWORD   dwInDiscards;     // received packets discarded 
  DWORD   dwInErrors;       // erroneous packets received 
  DWORD   dwInUnknownProtos;  // unknown protocol packets received 
  DWORD   dwOutOctets;      // octets sent 
  DWORD   dwOutUcastPkts;   // unicast packets sent 
  DWORD   dwOutNUcastPkts;  // non-unicast packets sent 
  DWORD   dwOutDiscards;    // outgoing packets discarded 
  DWORD   dwOutErrors;      // erroneous packets sent 
  DWORD   dwOutQLen;        // output queue length 
  DWORD   dwDescrLen;       // length of bDescr member 
  BYTE    bDescr[MAXLEN_IFDESCR];  // interface description 
} MIB_IFROW,*PMIB_IFROW;

Members

wszName[MAX_INTERFACE_NAME_LEN]
Pointer to a Unicode string that contains the name of the interface.
dwIndex
Specifies the index that identifies the interface.
dwType
Specifies the type of interface.
dwMtu
Specifies the Maximum Transmission Unit (MTU).
dwSpeed
Specifies the speed of the interface in bits per second.
dwPhysAddrLen
Specifies the length of the physical address specified by the bPhysAddr member.
bPhysAddr[MAXLEN_PHYSADDR]
Specifies the physical address of the adapter for this interface.
dwAdminStatus
Specifies the interface is administratively enabled or disabled.
dwOperStatus
Specifies the operational status of the interface. This member can be one of the following values.

MIB_IF_OPER_STATUS_NON_OPERATIONAL
MIB_IF_OPER_STATUS_UNREACHABLE
MIB_IF_OPER_STATUS_DISCONNECTED
MIB_IF_OPER_STATUS_CONNECTING
MIB_IF_OPER_STATUS_CONNECTED
MIB_IF_OPER_STATUS_OPERATIONAL

dwLastChange
Specifies the last time the operational status changed.
dwInOctets
Specifies the number of octets of data received through this interface.
dwInUcastPkts
Specifies the number of unicast packets received through this interface.
dwInNUcastPkts
Specifies the number of non-unicast packets received through this interface. Broadcast and multicast packets are included.
dwInDiscards
Specifies the number of incoming packets that were discarded even though they did not have errors.
dwInErrors
Specifies the number of incoming packets that were discarded because of errors.
dwInUnknownProtos
Specifies the number of incoming packets that were discarded because the protocol was unknown.
dwOutOctets
Specifies the number of octets of data sent through this interface.
dwOutUcastPkts
Specifies the number of unicast packets sent through this interface.
dwOutNUcastPkts
Specifies the number of non-unicast packets sent through this interface. Broadcast and multicast packets are included.
dwOutDiscards
Specifies the number of outgoing packets that were discarded even though they did not have errors.
dwOutErrors
Specifies the number of outgoing packets that were discarded because of errors.
dwOutQLen
Specifies the output queue length.
dwDescrLen
Specifies the length of the bDescr member.
bDescr[MAXLEN_IFDESCR]
Contains a description of the interface.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP4 or later.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Iprtrmib.h.

See Also

GetIfEntry, MIB_IFSTATUS, MIB_IFTABLE, MPR_INTERFACE_0