MIB_IFROW

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

IP Helper Structures
GetIfEntry
MIB_IFTABLE