ifmib.h) (MIB_IFROW 结构

MIB_IFROW结构存储有关特定接口的信息。

语法

typedef struct _MIB_IFROW {
  WCHAR                   wszName[MAX_INTERFACE_NAME_LEN];
  IF_INDEX                dwIndex;
  IFTYPE                  dwType;
  DWORD                   dwMtu;
  DWORD                   dwSpeed;
  DWORD                   dwPhysAddrLen;
  UCHAR                   bPhysAddr[MAXLEN_PHYSADDR];
  DWORD                   dwAdminStatus;
  INTERNAL_IF_OPER_STATUS 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;
  UCHAR                   bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;

成员

wszName[MAX_INTERFACE_NAME_LEN]

类型: WCHAR[MAX_INTERFACE_NAME_LEN]

指向包含接口名称的 Unicode 字符串的指针。

dwIndex

类型:DWORD

标识接口的索引。 禁用然后启用网络适配器时,此索引值可能会更改,不应将其视为永久性。

dwType

类型:DWORD

Internet 分配名称机构 (IANA) 定义的接口类型。 有关详细信息,请参阅 http://www.iana.org/assignments/ianaiftype-mibIpifcons.h 头文件中列出了接口类型的可能值。

下表列出了接口类型的常见值,尽管可能还有许多其他值。

含义
IF_TYPE_OTHER
1
其他一些类型的网络接口。
IF_TYPE_ETHERNET_CSMACD
6
以太网网络接口。
IF_TYPE_ISO88025_TOKENRING
9
令牌环网络接口。
IF_TYPE_FDDI
15
(FDDI) 网络接口的光纤分布式数据接口。
IF_TYPE_PPP
23
PPP 网络接口。
IF_TYPE_SOFTWARE_LOOPBACK
24
软件环回网络接口。
IF_TYPE_ATM
37
ATM 网络接口。
IF_TYPE_IEEE80211
71
IEEE 802.11 无线网络接口。
IF_TYPE_TUNNEL
131
隧道类型封装网络接口。
IF_TYPE_IEEE1394
144
IEEE 1394 (Firewire) 高性能串行总线网络接口。
IF_TYPE_IEEE80216_WMAN
237
适用于 WiMax 设备的移动宽带接口。
注意 Windows 7、Windows Server 2008 R2 及更高版本支持此接口类型。
 
IF_TYPE_WWANPP
243
适用于基于 GSM 的设备的移动宽带接口。
注意 Windows 7、Windows Server 2008 R2 及更高版本支持此接口类型。
 
IF_TYPE_WWANPP2
244
适用于基于 CDMA 的设备的移动宽带接口。
注意 Windows 7、Windows Server 2008 R2 及更高版本支持此接口类型。
 

dwMtu

类型:DWORD

最大传输单位 (MTU) 大小(以字节为单位)。

dwSpeed

类型:DWORD

接口的速度(以位/秒为单位)。

dwPhysAddrLen

类型:DWORD

bPhysAddr 成员指定的物理地址的长度(以字节为单位)。

bPhysAddr[MAXLEN_PHYSADDR]

类型: BYTE[MAXLEN_PHYSADDR]

此接口的适配器的物理地址。

dwAdminStatus

类型:DWORD

接口在管理上处于启用或禁用状态。

dwOperStatus

类型:DWORD

接口的操作状态。 此成员可以是 Ipifcons.h 头文件中定义的 INTERNAL_IF_OPER_STATUS 枚举中定义的以下值之一。

含义
IF_OPER_STATUS_NON_OPERATIONAL
LAN 适配器已被禁用,例如,由于地址冲突。
IF_OPER_STATUS_UNREACHABLE
未连接的 WAN 适配器。
IF_OPER_STATUS_DISCONNECTED
对于 LAN 适配器:网络电缆断开连接。 对于 WAN 适配器:无运营商。
IF_OPER_STATUS_CONNECTING
正在连接的 WAN 适配器。
IF_OPER_STATUS_CONNECTED
连接到远程对等互连的 WAN 适配器。
IF_OPER_STATUS_OPERATIONAL
LAN 适配器的默认状态

dwLastChange

类型:DWORD

时间长度,以百分之几秒 (10^-2 秒) ,从上次计算机重启开始,当接口进入其当前运行状态时开始。 此值在百分之 2^32 秒后滚动更新。

NDIS 当前不支持 dwLastChange 成员。 在 Windows Vista 及更高版本中,NDIS 对此成员返回零。 在早期版本的 Windows 上,此成员中为 NDIS 支持的接口返回任意值。 对于其他接口提供程序支持的接口,它们可能会返回适当的值。

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

类型:DWORD

bDescr 成员的长度(以字节为单位)。

bDescr[MAXLEN_IFDESCR]

类型: BYTE[MAXLEN_IFDESCR]

接口的说明。

注解

MIB_IFROW 结构的dwSpeed 成员对于 10 Gbit/s 网络适配器 (非常高速的网络接口不正确,例如,) ,因为 DWORD 中可以存储的最大值为 4,294,967,295。 应用程序应使用 GetIfEntry2GetIfTable2 函数返回的 MIB_IF_ROW2 结构或 GetAdaptersAddresses 函数返回的 IP_ADAPTER_ADDRESSES 结构来确定高速网络接口的速度。

在为 Windows Vista 及更高版本发布的 Microsoft Windows 软件开发工具包 (Windows SDK) (SDK) 中,头文件的组织方式已更改,MIB_IFROW结构在 Ifmib.h 头文件中定义,而不是 Iprtrmib.h 头文件中。 请注意,Ifmib.h 头文件会自动包含在 Iphlpapi.h 头文件中的 Iprtrmib.h 中。 不应直接使用 Ifmib.hIprtrmib.h 头文件。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 ifmib.h (包括 Iphlpapi.h)

另请参阅

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0