Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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 bPhysAddrmember.

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

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

See Also