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.
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