MIB_IFROW
A version of this page is also available for
4/8/2010
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.
- dwType
The type of 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
For LAN adapters: network cable disconnected. For WAN adapters: no carrier.
MIB_IF_OPER_STATUS_CONNECTING
WAN adapter that is in the process of 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 the operational status changed.
- 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 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.
Requirements
| Header | iprtrmib.h |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |