Partager via


2.2.1.2.29 MIB_IFROW

The MIB_IFROW structure stores information about a specific interface.

 typedef struct _MIB_IFROW {
   WCHAR wszName[256];
   DWORD dwIndex;
   DWORD dwType;
   DWORD dwMtu;
   DWORD dwSpeed;
   DWORD dwPhysAddrLen;
   BYTE bPhysAddr[8];
   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[256];
 } MIB_IFROW;

wszName: A pointer to a Unicode string that contains the name of the interface.

dwIndex: The index that identifies the interface. This index value is not persistent and can change when a network adapter is disabled and then enabled.

dwType: The interface type as defined by the Internet Assigned Names Authority (IANA) [IANAifType].

The following table lists common values for the interface type, although many other values are possible.

Value

Meaning

IF_TYPE_OTHER

0x00000001

Another type of network interface.

IF_TYPE_ETHERNET_CSMACD

0x00000006

An Ethernet network interface.

IF_TYPE_ISO88025_TOKENRING

0x00000009

A token ring network interface.

IF_TYPE_PPP

0x00000017

A PPP network interface.

IF_TYPE_SOFTWARE_LOOPBACK

0x00000018

A software loopback network interface.

IF_TYPE_ATM

0x00000027

An ATM network interface.

IF_TYPE_IEEE80211

0x00000047

An IEEE 802.11 wireless network interface.

IF_TYPE_TUNNEL

0x00000083

A tunnel type encapsulation network interface.

IF_TYPE_IEEE1394

0x00000090

An IEEE 1394 (FireWire) high-performance serial bus network interface.

dwMtu: The maximum transmission unit (MTU) size in bytes.

dwSpeed: The speed of the interface in bits per second.

dwPhysAddrLen: The length, in bytes, of the physical address specified by the bPhysAddr member.

bPhysAddr: The physical address of the adapter for this interface.

dwAdminStatus: The administrative status of the interface. It can be either enabled or disabled.

dwOperStatus: The operational status of the interface.

This member can be one of the following values.

Value

Meaning

IF_OPER_STATUS_NON_OPERATIONAL

0x00000000

LAN adapter has been disabled, for example, because of an address conflict.

IF_OPER_STATUS_UNREACHABLE

0x00000001

WAN adapter that is not connected.

IF_OPER_STATUS_DISCONNECTED

0x00000002

For LAN adapters: network cable disconnected. For WAN adapters: no carrier.

IF_OPER_STATUS_CONNECTING

0x00000003

WAN adapter that is in the process of connecting.

IF_OPER_STATUS_CONNECTED

0x00000004

WAN adapter that is connected to a remote peer.

IF_OPER_STATUS_OPERATIONAL

0x00000005

Default status for LAN adapters.

dwLastChange: The length of time, in hundredths of seconds, starting from the last computer restart, when the interface entered its current operational state.<32>

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 nonunicast packets received through this interface. Broadcast and multicast packets are included.

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.

dwOutUcastPkts: The number of unicast packets sent through this interface.

dwOutNUcastPkts: The number of nonunicast packets sent through this interface. Broadcast and multicast packets are included.

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 transmit queue length. This field is not currently used.

dwDescrLen: The length, in bytes, of the bDescr member.

bDescr: A null-terminated ASCII string that contains the description of the interface.