Share via


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

Header iprtrmib.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IP Helper Structures
GetIfEntry
MIB_IFTABLE