Platform SDK: Management Information Base 

MIB_IFROW



The MIB_IFROW structure stores information about a particular interface.





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 

Specifies the index that identifies the interface. 

dwType 

Specifies the type of interface. 

This member can be one of the following values:



MIB_IF_TYPE_OTHER

MIB_IF_TYPE_ETHERNET

MIB_IF_TYPE_TOKENRING

MIB_IF_TYPE_FDDI

MIB_IF_TYPE_PPP

MIB_IF_TYPE_LOOPBACK

MIB_IF_TYPE_SLIP



dwMtu 

Specifies the Maximum Transmission Unit (MTU). 

dwSpeed 

Specifies the speed of the interface in bits per second. 

dwPhysAddrLen 

Specifies the length of the physical address specified by the bPhysAddr member. 

bPhysAddr 

Specifies the physical address of the adapter for this interface. 

dwAdminStatus 

Specifies the interface is administratively enabled or disabled. 

dwOperStatus 

Specifies the operational status of the interface. This member can be one of the following values. 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 

Specifies the length of time, in centaseconds (10^-2 sec), that elapsed between January 1, 1601, and the last change of the operational status of the interface (connection). The value rolls over after 2^32 centaseconds. 

dwInOctets 

Specifies the number of octets of data received through this interface. 

dwInUcastPkts 

Specifies the number of unicast packets received through this interface. 

dwInNUcastPkts 

Specifies the number of non-unicast packets received through this interface. Broadcast and multicast packets are included. 

dwInDiscards 

Specifies the number of incoming packets that were discarded even though they did not have errors. 

dwInErrors 

Specifies the number of incoming packets that were discarded because of errors. 

dwInUnknownProtos 

Specifies the number of incoming packets that were discarded because the protocol was unknown. 

dwOutOctets 

Specifies the number of octets of data sent through this interface. 

dwOutUcastPkts 

Specifies the number of unicast packets sent through this interface. 

dwOutNUcastPkts 

Specifies the number of non-unicast packets sent through this interface. Broadcast and multicast packets are included. 

dwOutDiscards 

Specifies the number of outgoing packets that were discarded even though they did not have errors. 

dwOutErrors 

Specifies the number of outgoing packets that were discarded because of errors. 

dwOutQLen 

Specifies the output queue length. 

dwDescrLen 

Specifies the length of the bDescr member. 

bDescr 

Contains a description of the interface. 

Requirements

Client Requires Windows XP, Windows 2000 Professional, Windows NT Workstation 4.0 SP4 and later, Windows Me, or Windows 98. 

Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0 SP4 and later. 

Header Declared in Iprtrmib.h.

 



See Also

GetIfEntry, MIB_IFSTATUS, MIB_IFTABLE, MPR_INTERFACE_0

  

--------------------------------------------------------------------------------

 

  Last updated: March 2005  |  What did you think of this topic?  |  Order a Platform SDK CD 

  © Microsoft Corporation. All rights reserved. Terms of use. 



 



Requirements

Client Requires Windows XP, Windows 2000 Professional, Windows NT Workstation 4.0 SP4 and later, Windows Me, or Windows 98. 

Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0 SP4 and later. 

Header Declared in Iprtrmib.h.

 

See Also

GetIfEntry, MIB_IFSTATUS, MIB_IFTABLE, MPR_INTERFACE_0